Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Ralph Specum Index · tzachbon | DecimalAI

documentationby tzachbon

Ralph Specum Index

tzachbon/ralph-specum-index

Source tzachbon/smart-ralph ↗License MIT

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.

SkillScore86Maintained

Automatic

Doc Ops pack

Last verified 8/20/2026

What it changes

Passed 19 of 22 test cases with the skill, and 9 of 22 without it.

Without skill41%

With skill86%

Checks it passed that the model alone missed

Specifies output paths starting under specs/.index/
Places external endpoints under specs/.index/external/
Names the specific files that changed or were generated

and 11 more in the full report

12 fixed7 passed either way1 still failing2 broke

Pass-rate lift: +45 pp
Tokens: -11%
Agent turns: 0%
Response time: -25%

Model gemini-3.6-flashMeasured 8/20/2026v119 of 22 cases passed with skill

Tokens, turns and time describe resource use, not a dollar price.

Use this skill

Save it into your project's skills folder. Claude Code picks it up in its next session.

curl -fsSL --create-dirs -o .claude/skills/tzachbon-ralph-specum-index/SKILL.md https://app.decimal.ai/s/tzachbon-ralph-specum-index/SKILL.md

Want it pinned and updatable? pip install "decimalai>=0.15", then decimalai skills add tzachbon-ralph-specum-index, and start Claude Code with claude --plugin-dir "$(git rev-parse --show-toplevel)/.agents"

1 · One-time — install the CLI (docs ↗)

pip install "decimalai>=0.15"

2 · Get the skill — writes .agents/skills/tzachbon-ralph-specum-index/ and pins it in .decimal/skills.lock

decimalai skills add tzachbon-ralph-specum-index

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/tzachbon-ralph-specum-index/SKILL.md https://app.decimal.ai/s/tzachbon-ralph-specum-index/SKILL.md

Raw file: /s/tzachbon-ralph-specum-index/SKILL.md ↗ · machine-readable summary at /s/tzachbon-ralph-specum-index.json ↗

Safety checks: 3 of 3 passed

Code scan CleanIntent PassedContent Clean

See it in action

One of 12 test cases the skill fixed. Same model, same prompt, with and without the skill.

1 of 12

Prompt

Execute a quick mode index scan over `src/models/` to refresh component specs.

What was checked, without and with the skill
Checked	Without skill	With skill
Executes index scan under specs/.index/ reflecting quick mode scope	Missed	Passed

case-21 · gemini-3.6-flash · 8/20/2026 · answers are capped and redacted

What's inside

The instructions your model reads when the skill loads.

SKILL.md30 linessingle file

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.md
- specs/.index/components/*.md
- specs/.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 artifact
- request changes
- continue to research
Treat continue to research as approval of the updated index artifacts.

Track record

Benchmark

19 / 22

test cases passed, vs 9 / 22 without

Adoption

Users: 0
Times used: 0

Safety and source details

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/3/2026

View 15 scanner checks

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

tzachbon / smart-ralph

plugins/ralph-specum-codex/skills/ralph-specum-index/SKILL.md

View on GitHub ↗

License MITImported 8/3/2026Version v1

More skills from the same source and nearby in the registry, with their headline benchmark lift.

Ready to supercharge your AI agents?

See it in action

What's inside

Ralph Specum Index

Contract

Action

Response Handoff

Track record

Benchmark

Adoption

SkillSafety

Source

Related skills