Agent skill

repo-intake

Project initialization inventory (one-time). Use when: first onboarding a project, rebuilding cache after structural changes. Not for: day-to-day development (read cache directly), finding specific files (use code-explore). Output: project map with entrypoints + test map + next steps.

Stars 139
Forks 18

Install this agent skill to your Project

npx add-skill https://github.com/sd0xdev/sd0x-dev-flow/tree/main/skills/repo-intake

SKILL.md

Repo Intake

When to Use

  • First time onboarding a project
  • Rebuilding cache after major project structural changes
  • Cache expired, needs updating

When NOT to Use

  • Already familiar with project structure (read cache directly)
  • Only need to find specific files (use Glob/Grep)
  • Day-to-day development (cache already exists)

Workflow

Docs -> Entrypoints -> Tests Map -> Next Steps

Usage

bash
bash scripts/run-skill.sh repo-intake intake_cached.js --mode auto --top 10

Cache Location

Cache stored at: ~/.claude/cache/repo-intake/<repoKey>/

File Description
latest.md Latest scan results
latest.json Latest scan results (JSON)
LATEST.json Cache metadata

Output

markdown
## Overview

<summary>

## Entrypoints

- {CONFIG_FILE}
- {BOOTSTRAP_FILE}

## Test Map

| Type        | Pattern           |
| ----------- | ----------------- |
| Unit        | test/unit/        |
| Integration | test/integration/ |
| E2E         | test/e2e/         |

## Next Steps

- <questions>

Verification

  • Output includes Overview, Entrypoints, Test Map, Next Steps
  • Entrypoints correctly identify {CONFIG_FILE}, {BOOTSTRAP_FILE}
  • Test Map covers Unit/Integration/E2E layers

References

  • references/archived/MIDWAY_HEURISTICS.md — Legacy MidwayJS heuristics (archived, for reference only)

Scripts

Script Purpose
scripts/intake_cached.js Main intake with caching
scripts/scan_repo.js Full repo scanner (framework-agnostic)
scripts/scan_delta.js Delta scan for changed files

Examples

Input: /repo-intake
Action: Execute intake script -> Output project map
Input: /repo-intake save
Action: Execute intake script -> Output and write to docs/ai/intake/

Expand your agent's capabilities with these related and highly-rated skills.

sd0xdev/sd0x-dev-flow

runbook

Generate and update feature release runbooks from existing docs and codebase. Use when: creating operational runbook, release handbook, deployment checklist, pre-release preparation. Not for: incident response (v2), code review (use codex-code-review), architecture design (use architecture).

139 18
Explore
sd0xdev/sd0x-dev-flow

ask

Context-aware Q&A with auto context gathering. Use when: user has a quick question about codebase, git history, rules, docs, or skills during development. Not for: code changes (use feature-dev), code review (use codex-review-fast), deep research (use deep-research), full code trace (use code-explore). Output: structured answer with source attribution.

139 18
Explore
sd0xdev/sd0x-dev-flow

project-brief

Convert a technical spec into a PM/CTO-readable executive summary. Simplify technical details, focus on business value.

139 18
Explore
sd0xdev/sd0x-dev-flow

codex-test-gen

Generate unit tests for specified functions using Codex MCP

139 18
Explore
sd0xdev/sd0x-dev-flow

bug-fix

Bug fix workflow. Use when: fixing bugs, resolving issues, regression fixes. Not for: new features (use feature-dev), understanding code (use code-explore). Output: fix + regression test + review gate.

139 18
Explore
sd0xdev/sd0x-dev-flow

skill-health-check

Validate skill quality against routing, progressive loading, and verification criteria. Use when: auditing skills, checking skill health, reviewing skill design. Not for: code review (use codex-code-review) or doc review (use doc-review). Output: health report with per-skill ratings + Gate.

139 18
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results