Skip to content

docs: align SKILL.md and CLAUDE.md with actual CLI behavior#25

Merged
sofq merged 3 commits into
mainfrom
docs/skill-alignment
Apr 14, 2026
Merged

docs: align SKILL.md and CLAUDE.md with actual CLI behavior#25
sofq merged 3 commits into
mainfrom
docs/skill-alignment

Conversation

@sofq

@sofq sofq commented Apr 14, 2026

Copy link
Copy Markdown
Owner

Summary

  • Refactor SKILL.md for better agent triggering with progressive disclosure and reference files
  • Fix incorrect flag names: --name--label (labels), --max-events--max-polls (watch)
  • Fix exit code 6 description from "permission denied" to "conflict (409)" and add missing exit code 7 (server error)

Test plan

  • Verify cf labels add --label works correctly
  • Verify cf watch --max-polls works correctly
  • Verify exit codes match internal/errors/errors.go

sofq added 2 commits April 14, 2026 15:48
…e disclosure

Rewrite skill description to be action-oriented with broader trigger
coverage (Atlassian, wiki, knowledge base). Add compatibility field.
Extract preset table, batch command mapping, security config, and
troubleshooting into references/ for on-demand loading, cutting the
main SKILL.md from ~444 to ~252 lines.
- labels: --name → --label (matches cmd/labels.go)
- watch: --max-events → --max-polls (matches cmd/watch.go)
- exit code 6: "permission denied" → "conflict (409)" (matches ExitConflict)
- exit code 7: add missing "server error (5xx)" (matches ExitServer)
@codecov

codecov Bot commented Apr 14, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

…ilities

Fixes GO-2026-4947, GO-2026-4946, GO-2026-4870 flagged by govulncheck.
@sofq sofq merged commit bde1104 into main Apr 14, 2026
14 checks passed
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