Skip to content

docs(education): fix first-skill capability examples - #981

Merged
justinmclean merged 1 commit into
apache:mainfrom
kushin25:kushin25/docs-fix-first-skill-tags
Jul 28, 2026
Merged

docs(education): fix first-skill capability examples#981
justinmclean merged 1 commit into
apache:mainfrom
kushin25:kushin25/docs-fix-first-skill-tags

Conversation

@kushin25

Copy link
Copy Markdown
Contributor

Summary

Corrects invalid beginner-guide capability examples and the command used to launch the skill-authoring guide.

Changes

  • replaces three undefined capability:* examples with documented capability labels;
  • changes both /write-skill references to /magpie-write-skill.

Related issue

Closes #974

Validation

  • git diff --check — passed
  • verified each of the five displayed capability labels is listed in docs/labels-and-capabilities.md
  • verified both command references use /magpie-write-skill
  • uvx --from 'prek>=0.4.9' prek run --all-files — could not complete locally because the available uv 0.11.6 is below this repository's declared minimum >=0.11.8; the failure occurred in project tooling, before the uv-backed validation hooks could run.

Notes

This small documentation patch was drafted with AI assistance and reviewed by its submitter. It changes only the file named in the issue.

Use capability labels defined by the framework and correct the magpie-write-skill command in the beginner guide.\n\nCloses apache#974.

@justinmclean justinmclean left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Verified: all five labels in the new text (triage, authoring, review, fix, intake) appear in the Axis-1 table in docs/labels-and-capabilities.md; the three removed ones (security, release, contributor-growth) exist nowhere. skills/write-skill/SKILL.md declares name: magpie-write-skill, so /magpie-write-skill is right. Thanks for fixing this!

@justinmclean
justinmclean merged commit 60cc560 into apache:main Jul 28, 2026
9 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.

Fix the invalid capability tags and the wrong slash command in your-first-skill.md

2 participants