
Ralph Specum Index
Should be used only when the user explicitly asks to use `$ralph-specum-index`, or...
Install
npx skills add tzachbon/smart-ralph --skill ralph-specum-index -g -a claude-code -y- Repository
- tzachbon/smart-ralph566
- Category
- Engineering
- Updated
- 8d ago
- License
- MIT
- Context cost
- Lightabout 309 tokens
- Runs scripts
- No, instructions only
What it does
This skill should be used only when the user explicitly asks to use `$ralph-specum-index`, or explicitly asks Ralph Specum in Codex to generate or refresh index artifacts.
Ralph Specum Index
Use this to generate searchable index specs for an existing codebase.
Contract
- Index output lives under
specs/.index/ - Use stable Ralph templates for
index.md, component specs, and external specs - Keep component and external entries deterministic and easy to diff
Action
- Parse the user scope such as path, types, excludes, quick mode, dry run, or force.
- Scan the requested code areas for controllers, services, models, helpers, migrations, or comparable project structures.
- Generate or update:
specs/.index/index.mdspecs/.index/components/*.mdspecs/.index/external/*.md
- Keep outputs deterministic so start, research, and triage can reuse them.
- Include external URLs, MCP endpoints, or installed skills only when the user asked for them or they are clearly relevant.
- In dry run mode, report what would be created without writing files.
Response Handoff
- After updating the index, name the files that changed and summarize the index scope briefly.
- End with exactly one explicit choice prompt:
approve current artifactrequest changescontinue to research
- Treat
continue to researchas approval of the updated index artifacts.
