Agent skill

Project Discovery

by rsmdt in rsmdt/the-startup

Unified codebase discovery across structure navigation, tech-stack detection, and documentation extraction.

MITAuto-check passedProduct & Project Management

Install Project Discovery

skills CLI
$ npx skills add rsmdt/the-startup --skill project-discovery -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install rsmdt/the-startup project-discovery --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/rsmdt/the-startup.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/team/skills/cross-cutting/project-discovery .claude/skills/project-discovery && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
project-discovery
GitHub stars
551
Token cost
~590 tokens
SKILL.md length
215 words
Files
4
Skills in repo
27
Repo updated
First seen
Licence
MIT

At a glance

Unified codebase discovery across structure navigation, tech-stack detection, and documentation extraction.

  • Works in 4 steps: Map Structure → Detect Stack → Extract and Verify Docs → …
  • Onboarding to a project
  • SKILL.md covers Persona, Interface, Constraints and Reference Materials, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Project Discovery is an agent skill from rsmdt/the-startup. Unified codebase discovery across structure navigation, tech-stack detection, and documentation extraction. Use when onboarding to a project, locating implementation paths, identifying frameworks/tooling, or validating docs against code reality.

Its SKILL.md is about 590 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files (for example `reference/error-handling-patterns.md`, `reference/framework-signatures.md` and `reference/search-patterns.md`).

It sits in Product & Project Management. The repository describes itself as: The Agentic Startup - A collection of Claude Code commands, skills, and agents. The licence is MIT.

When your agent uses it

  • Onboarding to a project
  • Locating implementation paths
  • Identifying frameworks/tooling
  • Validating docs against code reality

Example prompts

  • “/project-discovery”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Map Structure
  2. Detect Stack
  3. Extract and Verify Docs
  4. Build Discovery Report

What it can do on your machine

Read from SKILL.md and the folder at commit 88d447c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Project Discovery loads about 590 tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 215 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~66
When it runs · the whole SKILL.md, loaded when a task matches
~590

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from rsmdt/the-startup at commit 88d447c, republished under its MIT licence (© rsmdt). 215 words, ~590 tokens.

Download SKILL.mdSave it as .claude/skills/project-discovery/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
project-discovery
description
Unified codebase discovery across structure navigation, tech-stack detection, and documentation extraction. Use when onboarding to a project, locating implementation paths, identifying frameworks/tooling, or validating docs against code reality.

Persona

Act as a project discovery specialist that builds a fast, reliable map of a codebase: structure, stack, and documentation truth.

Discovery Target: $ARGUMENTS

Interface

ProjectDiscoveryReport { architecture: string techStack: string[] packageManagers: string[] keyEntryPoints: string[] criticalDocs: string[] docMismatches: string[] conventions: string[] confidence: HIGH | MEDIUM | LOW }

State { target = $ARGUMENTS files = [] docs = [] findings = [] }

Constraints

Always:

  • Start with repo/documentation overview, then narrow to target scope.
  • Verify framework detection using multiple signals (manifest + config + structure).
  • Cross-check critical documentation claims against implementation.
  • Prefer narrow searches in relevant directories after initial mapping.

Never:

  • Assume stack or architecture from a single indicator.
  • Treat docs as authoritative without verification for high-impact claims.
  • Scan dependency/vendor directories unless explicitly required.

Reference Materials

  • reference/search-patterns.md — Glob/Grep patterns for structure analysis, implementation tracing, and architecture mapping
  • reference/framework-signatures.md — Detection signatures for frontend, backend, build, CSS, DB, testing, API, monorepo, mobile, and deployment frameworks
  • reference/error-handling-patterns.md — Error classification, handling patterns, and logging level guidance

Workflow

1. Map Structure
  • Identify top-level modules, entry points, and test locations.
  • Identify config/manifests for language/tooling.
2. Detect Stack
  • Detect ecosystems/package managers from lock/manifests.
  • Detect frameworks/build/test tooling from dependency + config + file layout.
3. Extract and Verify Docs
  • Read README/spec/config docs relevant to target.
  • Flag outdated, conflicting, or missing documentation.
4. Build Discovery Report
  • Summarize architecture, stack, conventions, and verified/mismatched doc claims.
  • Highlight unknowns and next best inspection steps.

© rsmdt, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files in plugins/team/skills/cross-cutting/project-discovery of rsmdt/the-startup.

  • SKILL.md
  • reference/error-handling-patterns.md
  • reference/framework-signatures.md
  • reference/search-patterns.md

Open the folder on GitHubat commit 88d447c

Compare with similar skills

Project Discovery next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Project Discovery compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Project Discovery this skillrsmdt/the-startup551—~590Automated safety check: PassMIT
User Story Writerdeanpeters/Product-Manager-Skills7.2k2 repos~2.9kAutomated safety check: PassCustom licence
Game Changing FeaturesopenstatusHQ/data-table-filters2.3k3 repos~2.1kAutomated safety check: PassMIT
CCPM Project Managementautomazeio/ccpm8.4k—~1.1kAutomated safety check: PassMIT
Convex Create Componentspokvulcan/poker-planning1148 repos~2.6kAutomated safety check: PassMIT
Self Improving Agentfarm-fe/farm5.6k2 repos~3.3kAutomated safety check: NotesMIT

Similar skills

  • User Story Writer

    deanpeters/Product-Manager-Skills

    Writes user stories in Mike Cohn's format with Gherkin acceptance criteria, turning user needs into development-ready work with testable conditions.

    7.2k GitHub starsUsed in 2 repos~2.9k tokens
    Product & Project ManagementAuto-check passed
  • Game Changing Features

    openstatusHQ/data-table-filters

    Find 10x product opportunities and high-leverage improvements.

    2.3k GitHub starsUsed in 3 repos~2.1k tokens
    Product & Project ManagementAuto-check passed
  • Runs a spec-driven workflow from PRD to epic to GitHub issues to parallel agents, with status, standup and blocked-work reports from bundled scripts.

    8.4k GitHub stars~1.1k tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check passed
  • Convex Create Component

    spokvulcan/poker-planning

    Builds reusable Convex components with isolated tables and app-facing APIs.

    114 GitHub starsUsed in 8 repos~2.6k tokens
    Product & Project ManagementAuto-check passed
  • A universal self-improving agent that learns from ALL skill experiences.

    5.6k GitHub starsUsed in 2 repos~3.3k tokens
    Product & Project ManagementAuto-check: notes
  • Builds a weekly engineering retrospective from git history: commit counts, per-person contributions, work patterns and code quality numbers over a chosen window.

    136k GitHub stars~2.4k tokensUpdated today
    Product & Project ManagementAuto-check passed

More from rsmdt/the-startup

All 27 skills in this repo
  • Analyze

    rsmdt/the-startup

    Deep-dive codebase analysis that explains how things actually work — business rules, architecture patterns, auth flows, data models, integrations, and performance hotspots.

    551 GitHub stars~1.9k tokensUpdated 2 mo ago
    Auto-check passed
  • Implement

    rsmdt/the-startup

    Implementation entry point. An agent skill from rsmdt/the-startup.

    551 GitHub stars~1.3k tokensUpdated 2 mo ago
    Auto-check passed
  • Implement Factory

    rsmdt/the-startup

    Factory loop orchestrator for multi-feature or multi-component implementation manifests.

    551 GitHub stars~3.2k tokensUpdated 2 mo ago
    Auto-check passed
  • Agentic Patterns

    rsmdt/the-startup

    Context enrichment for agentic AI application development using LangChain, Vercel AI SDK, and assistant-ui.

    551 GitHub stars~501 tokensUpdated 2 mo ago
    Auto-check passed
  • API Contract Design

    rsmdt/the-startup

    REST and GraphQL API design patterns, OpenAPI/Swagger specifications, versioning strategies, and authentication patterns.

    551 GitHub stars~1.1k tokensUpdated 2 mo ago
    Auto-check passed
  • Architecture Selection

    rsmdt/the-startup

    System architecture patterns including monolith, microservices, event-driven, and serverless, with C4 modeling, scalability strategies, and technology selection criteria.

    551 GitHub stars~1.2k tokensUpdated 2 mo ago
    Auto-check passed

Questions about Project Discovery

What does Project Discovery do?

Unified codebase discovery across structure navigation, tech-stack detection, and documentation extraction. Project Discovery is an agent skill from rsmdt/the-startup. Unified codebase discovery across structure navigation, tech-stack detection, and documentation extraction.

When should I use Project Discovery?

Project Discovery fits situations like: onboarding to a project; locating implementation paths; identifying frameworks/tooling; validating docs against code reality.

How do I install Project Discovery in Claude Code?

Run `npx skills add rsmdt/the-startup --skill project-discovery -a claude-code`. Or copy the skill folder (plugins/team/skills/cross-cutting/project-discovery in rsmdt/the-startup) into .claude/skills/project-discovery in your project. Claude Code loads it when a task matches its description.

How do I install Project Discovery in Codex?

Run `npx skills add rsmdt/the-startup --skill project-discovery -a codex`. Or copy the skill folder (plugins/team/skills/cross-cutting/project-discovery in rsmdt/the-startup) into .agents/skills/project-discovery in your project. Codex loads it when a task matches its description.

Can I use Project Discovery in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add rsmdt/the-startup --skill project-discovery -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/project-discovery, .gemini/skills/project-discovery, .github/skills/project-discovery and .opencode/skills/project-discovery in your project.

What does Project Discovery need to run?

SKILL.md names no scripts, command-line tools or credentials: Project Discovery is instructions for the agent only.

Does Project Discovery access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Project Discovery safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Project Discovery use?

Project Discovery is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Project Discovery use?

About 590 tokens (SKILL.md is roughly 2.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Project Discovery?

Skills that share tags, products or a category with Project Discovery: User Story Writer (deanpeters/Product-Manager-Skills, 7.2k stars), Game Changing Features (openstatusHQ/data-table-filters, 2.3k stars), CCPM Project Management (automazeio/ccpm, 8.4k stars) and Convex Create Component (spokvulcan/poker-planning, 114 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Project Discovery?

rsmdt (a GitHub user) maintains it in rsmdt/the-startup, which has 551 GitHub stars. The repository holds 27 skills in this directory. The repository was last updated on August 3, 2026.

Source: rsmdt/the-startup on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.