New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Codebase Research Pass

by bbartling in bbartling/open-fdd

A skill your agent uses for structured research on an unfamiliar or complex codebase before planning, reviewing, or editing.

Custom licenceAuto-check passedAgent Workflows

Install Codebase Research Pass

skills CLI
$ npx skills add bbartling/open-fdd --skill codebase-research-pass -a claude-code

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

GitHub CLI
$ gh skill install bbartling/open-fdd codebase-research-pass --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/bbartling/open-fdd.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/codebase-research-pass .claude/skills/codebase-research-pass && 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
codebase-research-pass
GitHub stars
172
Token cost
~1.4k tokens
SKILL.md length
576 words
Files
3 (incl. references)
Skills in repo
23
Repo updated
First seen
Licence
Custom licence

At a glance

A skill your agent uses for structured research on an unfamiliar or complex codebase before planning, reviewing, or editing.

  • Works in 5 steps: Objective: one sentence describing the… → Scope: files, folders, PR diff,… → Constraints: read-only vs write,… → …
  • Structured research on an unfamiliar
  • SKILL.md covers Trigger, Non-goals, Operating principles and Subagent orchestration rules, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Codebase Research Pass is an agent skill from bbartling/open-fdd. Use for structured research on an unfamiliar or complex codebase before planning, reviewing, or editing. Delegates mapping, ownership, dependency, test, and risk discovery to focused subagents and returns an evidence-led research brief.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/output-contracts.md` and `references/severity-rubric.md`).

It sits in Agent Workflows, covering Subagents and Deep research. The repository describes itself as: Fault Detection Diagnostics (FDD) for HVAC datasets.

When your agent uses it

  • Structured research on an unfamiliar
  • Complex codebase before planning

Example prompts

  • “/codebase-research-pass”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Objective: one sentence describing the question to answer.
  2. Scope: files, folders, PR diff, services, packages, or docs to inspect.
  3. Constraints: read-only vs write, commands allowed, network/doc lookup allowed, and timeout.
  4. Required evidence: exact files/symbols/commands/sources to cite.
  5. Output schema: use the schema requested by the skill.

What it can do on your machine

Read from SKILL.md and the folder at commit b5c4e9c. 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 (its code samples are markdown).

    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

Codebase Research Pass loads about 1.4k tokens when it runs, and up to ~1.9k if it reads all its reference files. Until then it costs about 65 tokens; SKILL.md has 576 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~65
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.9k

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 576 words (~1,387 tokens).

“When the user asks to understand a codebase, map architecture, plan work, investigate a subsystem, onboard to a repo, or prepare for implementation/review.”

— opening of SKILL.md by bbartling, Custom licence
name
codebase-research-pass

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files (references) in .agents/skills/codebase-research-pass of bbartling/open-fdd.

  • SKILL.md
  • references/output-contracts.md
  • references/severity-rubric.md

Open the folder on GitHubat commit b5c4e9c

Compare with similar skills

Codebase Research Pass 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.

Codebase Research Pass compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Codebase Research Pass this skillbbartling/open-fdd172—~1.4kAutomated safety check: PassCustom licence
Dynamic WorkflowsTheBeardedBearSAS/claude-craft107—~1.4kAutomated safety check: PassMIT
Claw Multi AgentLeoYeAI/openclaw-master-skills2.2k—~5.5kAutomated safety check: PassMIT
Research Trackersundial-org/awesome-openclaw-skills663—~1kAutomated safety check: PassNone
Advanced Swarm Orchestrationruvnet/agentic-flow8165 repos~5.9kAutomated safety check: PassNone
Synthesisyologdev/yoyo-evolve1.9k—~3.1kAutomated safety check: PassMIT

Similar skills

  • Dynamic Workflows

    TheBeardedBearSAS/claude-craft

    Orchestrate dozens-to-hundreds of subagents from a script Claude writes (Claude Code Dynamic Workflows, trigger ultracode).

    107 GitHub stars~1.4k tokensUpdated 23 days ago
    Agent WorkflowsAuto-check passed

  • Claw Multi Agent

    LeoYeAI/openclaw-master-skills

    Multi-agent parallel orchestration for OpenClaw. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~5.5k tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed

  • Research Tracker

    sundial-org/awesome-openclaw-skills

    Manage autonomous AI research agents with SQLite-based state tracking.

    663 GitHub stars~1k tokensUpdated 7 mo ago
    Agent WorkflowsAuto-check passed

  • Advanced Swarm Orchestration

    ruvnet/agentic-flow

    Patterns for running multi-agent swarms on research, development and testing work, with four topologies and a four-phase research swarm built on claude-flow MCP tools.

    816 GitHub starsUsed in 5 repos~5.9k tokens
    Agent WorkflowsAuto-check passed

  • Synthesis

    yologdev/yoyo-evolve

    Multi-source research synthesis — aggregate and compare 3+ sources or any source 5KB using sub-agent dispatch and SharedState

    1.9k GitHub stars~3.1k tokensUpdated today
    Agent WorkflowsAuto-check passed

  • Web Research

    Juncai22/spring-ai-agent-learning

    A skill your agent uses for requests related to web research; it provides a structured approach to conducting comprehensive web research

    123 GitHub starsUsed in 3 repos~1.1k tokens
    Research & ScienceAuto-check passed

More from bbartling/open-fdd

All 23 skills in this repo

  • Architecture Design Review

    bbartling/open-fdd

    A skill your agent uses to evaluate architecture, design proposals, refactors, module boundaries, dependency direction, data flow, concurrency model, and maintainability tradeoffs across any codebase.

    172 GitHub stars~1.3k tokensUpdated today
    Auto-check passed

  • External Source Research

    bbartling/open-fdd

    A skill your agent uses when implementation or review depends on external documentation, standards, protocols, APIs, SDKs, changelogs, or version-specific behavior.

    172 GitHub stars~1.3k tokensUpdated today
    Auto-check passed

  • Multi Agent PR Review

    bbartling/open-fdd

    A skill your agent uses for rigorous pull request, branch, patch, or diff review.

    172 GitHub stars~1.4k tokensUpdated today
    Auto-check passed

  • Performance Ab Benchmark Review

    bbartling/open-fdd

    A skill your agent uses to design, run, or review performance work with reproducible A/B baselines.

    172 GitHub stars~1.4k tokensUpdated today
    Auto-check passed

  • Spec Contract Compliance Review

    bbartling/open-fdd

    A skill your agent uses to compare any codebase against a specification, API contract, protocol, policy, RFC, security baseline, or product requirements document.

    172 GitHub stars~1.4k tokensUpdated today
    Auto-check passed

  • Openfdd Ecm Engineering

    bbartling/open-fdd

    A skill your agent uses when migrating or changing generic ECM math in openfdd.ecmengineering, publishing PyPI ECM workbook exports, or Compare honesty (FITTED vs industry).

    172 GitHub stars~966 tokensUpdated today
    Auto-check passed

Categories

Questions about Codebase Research Pass

What does Codebase Research Pass do?

A skill your agent uses for structured research on an unfamiliar or complex codebase before planning, reviewing, or editing. Codebase Research Pass is an agent skill from bbartling/open-fdd. Use for structured research on an unfamiliar or complex codebase before planning, reviewing, or editing.

When should I use Codebase Research Pass?

Codebase Research Pass fits situations like: structured research on an unfamiliar; complex codebase before planning.

How do I install Codebase Research Pass in Claude Code?

Run `npx skills add bbartling/open-fdd --skill codebase-research-pass -a claude-code`. Or copy the skill folder (.agents/skills/codebase-research-pass in bbartling/open-fdd) into .claude/skills/codebase-research-pass in your project. Claude Code loads it when a task matches its description.

How do I install Codebase Research Pass in Codex?

Run `npx skills add bbartling/open-fdd --skill codebase-research-pass -a codex`. Or copy the skill folder (.agents/skills/codebase-research-pass in bbartling/open-fdd) into .agents/skills/codebase-research-pass in your project. Codex loads it when a task matches its description.

Can I use Codebase Research Pass 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 bbartling/open-fdd --skill codebase-research-pass -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/codebase-research-pass, .gemini/skills/codebase-research-pass, .github/skills/codebase-research-pass and .opencode/skills/codebase-research-pass in your project.

What does Codebase Research Pass need to run?

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

Does Codebase Research Pass 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 Codebase Research Pass 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 Codebase Research Pass use?

Codebase Research Pass has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Codebase Research Pass use?

About 1.4k tokens (SKILL.md is roughly 5.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 473 tokens, read only when the agent opens those files.

What are the alternatives to Codebase Research Pass?

Skills that share tags, products or a category with Codebase Research Pass: Dynamic Workflows (TheBeardedBearSAS/claude-craft, 107 stars), Claw Multi Agent (LeoYeAI/openclaw-master-skills, 2.2k stars), Research Tracker (sundial-org/awesome-openclaw-skills, 663 stars) and Advanced Swarm Orchestration (ruvnet/agentic-flow, 816 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Codebase Research Pass?

bbartling (a GitHub user) maintains it in bbartling/open-fdd, which has 172 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on October 7, 2026.

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