Skip to content

docs(sable-5u7): fix llms.txt typo + correct platform skill counts (B8)#131

Merged
Rome-1 merged 1 commit into
maylistfrom
sable-5u7-llms-fixes
May 19, 2026
Merged

docs(sable-5u7): fix llms.txt typo + correct platform skill counts (B8)#131
Rome-1 merged 1 commit into
maylistfrom
sable-5u7-llms-fixes

Conversation

@Rome-1

@Rome-1 Rome-1 commented May 19, 2026

Copy link
Copy Markdown
Collaborator

Summary

Two corrections found while cross-reading our `llms.txt` against `docs.rafter.so/llms.txt` and verifying against the current `AGENT_SKILLS` source.

Typo fix

Line 16 had a truncated sentence:

The two surfaces never overlap. `rafter secrets` is local-only; `rafter run` is remote-only (ode is immediately after analysis). Pick by the task, not by the name.

Looks like a partial edit artifact — the line at L139 in the same file uses the correct phrasing:

Remote scans send code to the Rafter backend solely for analysis; code is deleted immediately after. Secrets are never logged or returned in cleartext.

Aligned L16 to that wording.

Skill-count fix

The "Supported Agent Platforms" table understated skill counts:

Platform Before After
Claude Code "Pre/PostToolUse hooks + 2 skills" "Pre/PostToolUse hooks + 3 skills"
Codex CLI "2 security skills" "3 security skills"
OpenClaw "1 security skill" "Rafter Security skill (ClawHub)"

Verified against `node/src/commands/agent/init.ts:27 AGENT_SKILLS`, which lists three: `rafter`, `rafter-secure-design`, `rafter-code-review`. The fourth skill (`rafter-skill-review`, tightened in PR #126) is NOT in `AGENT_SKILLS` and so doesn't ship to platforms — separate question whether it should (filing as follow-up).

OpenClaw uses a different shape — the canonical ClawHub install at `~/.openclaw/workspace/skills/rafter-security/SKILL.md` (single SKILL.md, not the multi-skill tree).

Out of scope

  • The two llms.txt files (`docs.rafter.so/llms.txt` and ours) are intentionally different — they cover different audiences (docs site vs. CLI package). Their overall framing is consistent (agent-first security primitive, free local + paid remote, MIT, no telemetry). Only factual claims need to agree; those are now aligned.
  • Cross-rig coordination on the sibling llms.txt (held by the secbolt rig per maylist B8) is being nudged separately to juno.

Target: `maylist`.

Closes sable-5u7.

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 4.7 noreply@anthropic.com

Two corrections found while cross-reading our llms.txt against docs.rafter.so/llms.txt and verifying against the current AGENT_SKILLS source:

1. Line 16 had a truncated sentence — '(ode is immediately after analysis)'. Replaced with '(code is deleted immediately after analysis)' matching the wording at line 139 of the same file.

2. The Supported Agent Platforms table understated the skill count for Claude Code and Codex CLI. Both platforms install 3 security skills today (rafter, rafter-secure-design, rafter-code-review per node/src/commands/agent/init.ts:27 AGENT_SKILLS), not 2. OpenClaw installs the ClawHub-shaped rafter-security skill (single SKILL.md in workspace/skills/rafter-security/).

The docs.rafter.so/llms.txt is intentionally different — covers the docs site, not the package — but the factual claims (platform names, install flag, what install does) should agree. This commit aligns the factual claims.

Cross-rig coordination on the secbolt llms.txt is being nudged separately to juno.

Closes sable-5u7.
@Rome-1
Rome-1 merged commit d0dda9a into maylist May 19, 2026
@Rome-1
Rome-1 deleted the sable-5u7-llms-fixes branch May 19, 2026 05:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant