You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@magpie.apache.org by "potiuk (via GitHub)" <gi...@apache.org> on 2026/07/03 18:54:52 UTC
[PR] docs(skill-sources): add authoring guide for third-party skill-source contributors [magpie]
potiuk opened a new pull request, #708:
URL: https://github.com/apache/magpie/pull/708
## Summary
Adds `docs/skill-sources/authoring-a-source.md` — a step-by-step guide for **third-party repos/organizations** that want Magpie adopters to be able to pull *their* skills. It's the source-repo counterpart to `docs/skill-sources/README.md` (which covers the adopter side) and fills a gap left after the feature landed (Phase A #677 + Phase B #707).
Ten steps: two-tree layout → author skills in the Magpie shape → keep the eval binding resolvable → pick an org identity (`independent` or register one) → choose a distribution method + verification anchor → write the source descriptor → get listed for discovery → validate with Magpie's own `skill-and-tool-validate` → tell adopters how to pull it → maintain releases. Grounded in the actual validator contract (required frontmatter/descriptor keys, install methods) and cross-linked both ways with the README.
## Verification
`prek` clean on the new + edited docs — markdownlint, doctoc (TOC generated), typos, and **lychee (every relative cross-reference/anchor resolves)**.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
--
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
Re: [PR] docs(skill-sources): add authoring guide for third-party skill-source contributors [magpie]
Posted by "potiuk (via GitHub)" <gi...@apache.org>.
potiuk merged PR #708:
URL: https://github.com/apache/magpie/pull/708
--
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