project-discovery

Inspects an unfamiliar project read-only and produces a beginner-friendly overview of structure, skills, and rules.

Updated Jul 27, 2026
One-click install
npx skills add https://github.com/sebaperiesdigit-create/Peries-Skills-Master --skill project-discovery-sebaperiesdigit-create
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-discovery
Source: https://github.com/sebaperiesdigit-create/Peries-Skills-Master/tree/main/.claude/skills/project-discovery
Command: npx skills add https://github.com/sebaperiesdigit-create/Peries-Skills-Master --skill project-discovery-sebaperiesdigit-create

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? New team members often struggle to understand an unfamiliar codebase: what it does, which folders matter, what rules apply, and what they can safely touch. This Skill performs a read-only inspection and delivers a clear onboarding summary without modifying anything. ## Core Features & Use Cases - Structured Project Scan: Reads README, CLAUDE.md, config files, and top-level directories to explain the project's purpose and layout. - Skills and MCP Discovery: Lists available Claude Skills from .claude/skills/ and detects MCP connector configurations without exposing secrets. - Git and Safety Context: Reports branch, recent commits, standing rules, and recommends one safe first action. - Use Case: A new employee opens a project for the first time and asks for a tour; the Skill returns a beginner-friendly summary of purpose, folders, available skills, restrictions, and a recommended next step. ## Quick Start Ask the assistant to explore this project and give you a tour of what it contains and what you can safely do.

Frequently Asked Questions about project-discovery

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I understand an unfamiliar codebase quickly?▼

Run a read-only project discovery scan that reads the README, config files, and top-level directories, then summarizes the project's purpose, structure, and rules. This Skill automates that process and ends with a recommended safe first action.

How to list available Claude Skills in a project?▼

The Skill inspects the .claude/skills/ directory and reads only the frontmatter of each SKILL.md to extract names and descriptions. It avoids scanning full file bodies so embedded template examples are not misattributed.

Does project discovery expose API keys or secrets?▼

No. The Skill explicitly never displays passwords, API keys, tokens, connection strings, or raw config values. When it finds MCP configuration, it reports only the connector name, filename, and whether configuration appears present.

Can this tool modify or run anything in my project?▼

No. It is strictly read-only: it never edits files, installs packages, runs migrations, starts services, or tests live MCP connectivity. Bash use is limited to git status, git branch, and git log.

What happens if the project is not a Git repository?▼

The Skill attempts git status, branch, and log commands, and if any fail it reports that the folder is not a Git repository or Git is unavailable, then continues with the rest of the inspection gracefully.