Skip to content

docs(claude): drop Skill-vs-Command split from testing-command table#72

Open
WilcoLouwerse wants to merge 1 commit into
mainfrom
docs/clarify-skills-not-commands
Open

docs(claude): drop Skill-vs-Command split from testing-command table#72
WilcoLouwerse wants to merge 1 commit into
mainfrom
docs/clarify-skills-not-commands

Conversation

@WilcoLouwerse
Copy link
Copy Markdown
Contributor

Summary

docs/claude/commands.md had a "Type" column that labelled some testing entries as Skill and others as Command (1 agent), perpetuating a split that no longer exists in Claude Code.

  • Anthropic merged custom commands into skills (docs): "Custom commands have been merged into skills. A file at .claude/commands/deploy.md and a skill at .claude/skills/deploy/SKILL.md both create /deploy and work the same way."
  • This workspace was always skill-only — no .claude/commands/ directory has ever existed.

The column was actually carrying two facts: skill-vs-command (false split) and parallel-agent count (real info). Renamed the column to Agents so the agent-count info is preserved and added a one-line note above the table explaining the merge.

Test plan

  • Skim docs/claude/commands.md §Testing Commands → table renders, intro reads cleanly, agent counts (1, 8, "1 or 6") are unchanged
  • No other doc in .github/docs/ still draws a Skill-vs-Command type distinction

🤖 Generated with Claude Code

Claude Code merged custom commands into skills (docs.claude.com),
and this workspace was always skill-only. The Type column in the
testing-commands table distinguished "Skill" from "Command (1 agent)"
which perpetuated an outdated split. Rename to "Agents" so the
parallel-agent count info is preserved without the false dichotomy,
and add a one-line note above the table.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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