Claude MarketplacesSubmit
tzachbon avatar

Ralph Specum Index

tzachbon/smart-ralph

Ralph Specum Index generates and maintains a searchable inventory of your codebase under `specs/.index/`. You call it explicitly when you want Ralph to catalog controllers, services, models, and other project structures into stable markdown artifacts. It's designed to be deterministic so the output diffs cleanly and other Ralph skills can reference it for research and triage. The skill supports scoping by path, dry runs, and optional external dependency tracking. Think of it as creating a table of contents for your code that both humans and Claude can navigate. Works best when you need to orient a large or unfamiliar codebase before making changes.

GitHub stars
340
last updated
May 19, 2026
View on GitHub

Install

$ npx -y skills add tzachbon/smart-ralph --skill ralph-specum-index --agent claude-code

Installs into .claude/skills of the current project.

Files

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

  1. Parse the user scope such as path, types, excludes, quick mode, dry run, or force.
  2. Scan the requested code areas for controllers, services, models, helpers, migrations, or comparable project structures.
  3. Generate or update:
    • specs/.index/index.md
    • specs/.index/components/*.md
    • specs/.index/external/*.md
  4. Keep outputs deterministic so start, research, and triage can reuse them.
  5. Include external URLs, MCP endpoints, or installed skills only when the user asked for them or they are clearly relevant.
  6. In dry run mode, report what would be created without writing files.

Response Handoff

SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Details

Repository
github.com/tzachbon/smart-ralph
Category
Marketing & SEO
License
MIT
First seen
Jun 11, 2026

More from tzachbon/smart-ralph

All 28

Recommended

More Marketing & SEO
1kostja94 avatarlinkedin-postskostja94/marketing-skillsWhen the user wants to create LinkedIn post copy or optimize for LinkedIn. Also use when the user mentions "LinkedIn post," "LinkedIn article," "professional po3.7Kskills.sh installs
2kostja94 avatarpinterest-postskostja94/marketing-skillsWhen the user wants to create Pinterest Pins, optimize Pin descriptions, or grow Pinterest presence. Also use when the user mentions "Pinterest," "Pin," "Pinter2.2Kskills.sh installs
3kostja94 avatargoogle-adskostja94/marketing-skillsWhen the user wants to set up, optimize, or manage Google Ads campaigns. Also use when the user mentions "Google Ads," "Google Search Ads," "PPC," "SEM," "PMF t1.7Kskills.sh installs
4kostja94 avatargenerative-engine-optimizationkostja94/marketing-skillsWhen the user wants to optimize for AI search visibility (ChatGPT, Claude, Perplexity, AI Overviews). Also use when the user mentions "GEO," "AEO," "generative 1.4Kskills.sh installs
5kostja94 avatarschema-markupkostja94/marketing-skillsWhen the user wants to add or optimize structured data (Schema.org, JSON-LD). Also use when the user mentions "schema," "structured data," "JSON-LD," "rich resu1.4Kskills.sh installs
6kostja94 avatarrobots-txtkostja94/marketing-skillsWhen the user wants to configure, audit, or optimize robots.txt. Also use when the user mentions "robots.txt," "crawler rules," "block crawlers," "AI crawlers,"1.3Kskills.sh installs