add-guide-file

add-guide-file is a skill for Claude Code from rajdeepratan/SlashForge. It costs 40 tokens per session (601 once invoked), scanned A, original, MIT.

A recipe for adding a guide file to a SlashForge installation kit. The guide is a reference document that an agent reads while working, and the recipe also connects it to the installer.

In plain words
What is it for?
Use it to create a workflow or reference guide, register it for installation, link it from another guide, and regenerate the render snapshot.
Why use it?
It prevents a new guide from being omitted, unreachable, too long, or written with invalid host-specific sections.

Skill for Claude Code

Written for Claude Code: installed under .claude/. Also seen: mentions Codex.

Needs its repository: it runs a file that does not travel with it, so clone the repository first. The line is node scripts/snapshot-claude-render.js.

Good fit Use it to create a workflow or reference guide, register it for installation, link it from another guide, and regenerate the render snapshot.

Compare 6 skills from other repositories ↓
Install

Getting it into your agent

It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.

Clone the repo
git clone --depth 1 https://github.com/rajdeepratan/SlashForge
agentmods
npx agentmods add skills/rajdeepratan/slashforge/add-guide-file

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for add-guide-file

README.md
[![agentmods](https://agentmods.dev/badge/skills/rajdeepratan/slashforge/add-guide-file/github.svg)](https://agentmods.dev/skills/rajdeepratan/slashforge/add-guide-file)
Your own site
<a href="https://agentmods.dev/skills/rajdeepratan/slashforge/add-guide-file"><img src="https://agentmods.dev/badge/skills/rajdeepratan/slashforge/add-guide-file/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for add-guide-file

Your own site · 80×15
<a href="https://agentmods.dev/skills/rajdeepratan/slashforge/add-guide-file"><img src="https://agentmods.dev/badge/skills/rajdeepratan/slashforge/add-guide-file.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 40 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 601 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00040 $0.00601
Opus 5.5 $0.00016 $0.00240
Sonnet 5.5 $0.00008 $0.00120
Haiku 4.5 $0.00004 $0.00060

Measured 7d ago against content hash c1be026be8c9, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

add-guide-file scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 7d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/add-guide-file/SKILL.md · 43 lines

What it actually says

Add a guide file

A "guide" is a templates/slashforge-*.md reference that is installed next to the commands and read by agents at runtime (e.g. slashforge-workflow-verify.md). This recipe adds one and wires it so the installer actually ships it.

Before starting

Read .claude/rules/templates.md (authoring rules) and .claude/rules/cli.md (installer conventions).

Steps

  1. Create the file at templates/slashforge-<name>.md. Start with YAML frontmatter (name, description) and keep the body ≤ 200 lines. If it would run longer, split it and link a sibling guide.
  2. Use per-host target blocks for any host-specific wording — balanced <!--target:claude-->…<!--/target--> / <!--target:agents-->…<!--/target-->. Valid names: claude, agents, cursor, codex, neutral.
  3. Register it in the installer. Add the filename to the GUIDE_FILES array in bin/install.js (keep it near related guides). An unregistered guide is never installed.
  4. Reference it from whatever guide or command loads it (e.g. a workflow.md "companion files" list). A guide nothing points to is dead weight.
  5. Run the tests — npm test. Frontmatter, line-limit, and target-block checks run here.
  6. Regenerate the Claude render snapshot (the pinned-render test will otherwise fail, by design):
    node scripts/snapshot-claude-render.js
    git diff test/fixtures/claude-render
    
    Review the diff: the new guide should appear, and nothing unrelated should change.
  7. Update CHANGELOG.md under ## [Unreleased] describing the new guide.

Verify

  • File is ≤ 200 lines with valid frontmatter
  • Every <!--target:x--> has a matching <!--/target-->; all target names are valid
  • Filename added to GUIDE_FILES in bin/install.js
  • At least one existing guide/command references the new file
  • npm test passes
  • test/fixtures/claude-render regenerated and the diff reviewed
  • CHANGELOG.md updated
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 7d ago First seen · 43 lines · 40 tokens per session scan A c1be026be8c9

Subscribe to this mod's changes

add-guide-file is a skill published in the GitHub repository rajdeepratan/SlashForge (5 stars, last pushed 2d ago), licensed MIT. It adds 40 tokens to every session and 601 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-10-09.