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

["justinmclean (via GitHub)" <gi...@apache.org>]

justinmclean opened a new issue, #974:
URL: https://github.com/apache/magpie/issues/974

   ## Summary
   
   The beginner on-ramp page `docs/education/your-first-skill.md` gives two instructions that do
   not work: three of the five example capability tags do not exist, and the command it tells the
   reader to run for the authoring skill is not the skill's real name. Fix both.
   
   ## Background
   
   This page is the first thing a new contributor reads before writing a skill, and both errors
   land in their first ten minutes.
   
   **Capability tags (Step 2).** The page suggests `capability:triage`, `capability:authoring`,
   `capability:security`, `capability:release`, and `capability:contributor-growth`. Only the
   first two exist. `docs/labels-and-capabilities.md` defines exactly ten skill capabilities, and
   the last three are not among them — they appear zero times in `skills/`. Worse, Step 4 of the
   same page tells the reader the validator checks the capability tag, so someone who picks one of
   the invalid ones only finds out after writing their whole skill.
   
   **Slash command.** The page says the authoring skill is run with `/write-skill`, in two places.
   The skill's frontmatter name is `magpie-write-skill`, and `CONTRIBUTING.md` invokes it as
   `/magpie-write-skill`.
   
   ## Where to look
   
   - `docs/education/your-first-skill.md` lines 175-176 — the capability-tag list at the end of
     Step 2.
   - `docs/education/your-first-skill.md` line 33 and line 400 — the two `/write-skill` mentions.
   - `docs/labels-and-capabilities.md` — the table of the ten valid skill capabilities, to pick
     replacements from.
   - `CONTRIBUTING.md` line 743 — an example of the correct slash-command form.
   
   ## Acceptance criteria
   
   - [ ] Every capability tag listed on the page appears in the capability table in
         `docs/labels-and-capabilities.md`.
   - [ ] Both `/write-skill` mentions read `/magpie-write-skill`.
   - [ ] No other file is changed.
   - [ ] `prek run --all-files` passes.
   
   ## Estimated effort
   
   ~30-45 minutes for someone new to the codebase.
   
   ## Getting started
   
   [[How to contribute](https://github.com/apache/airflow-steward/blob/main/CONTRIBUTING.md#your-first-contribution)](https://github.com/apache/airflow-steward/blob/main/CONTRIBUTING.md#your-first-contribution)
   
   This issue was drafted with the help of an AI-assisted tool and reviewed by a Magpie maintainer before posting. If anything here is unclear or looks wrong, say so on the issue: a real person is reading.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@magpie.apache.org.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org

Re: [I] Fix the invalid capability tags and the wrong slash command in your-first-skill.md [magpie]

["justinmclean (via GitHub)" <gi...@apache.org>]

justinmclean closed issue #974: Fix the invalid capability tags and the wrong slash command in your-first-skill.md
URL: https://github.com/apache/magpie/issues/974


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@magpie.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org