tzachbon/smart-ralph / plugins/ralph-specum-codex/skills/ralph-specum-index
ralph-specum-index
VerifiedThis 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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |