Skip to content

Update onboarding and contributor docs for dual distribution#18

Draft
snissn wants to merge 1 commit intofeat/claude-skill-mcp-supportfrom
feat/claude-skill-docs-onboarding
Draft

Update onboarding and contributor docs for dual distribution#18
snissn wants to merge 1 commit intofeat/claude-skill-mcp-supportfrom
feat/claude-skill-docs-onboarding

Conversation

@snissn
Copy link
Copy Markdown
Contributor

@snissn snissn commented Mar 19, 2026

Summary

This PR covers issue #13 PR 5: documentation, onboarding, and contributor workflow updates for the canonical-pack plus generated-skill model.

What changed

  • rewrote README.md around the dual-distribution model
  • updated CONTRIBUTING.md to make the canonical-pack-first rule explicit
  • added a dedicated tutorial:
    • tutorials/use-agent-hub-claude-compatible-skills.md
  • updated the MCP tutorial to explain canonical packs vs generated Claude-compatible skills
  • updated the onboarding prompt so the installed routing note teaches agents when MCP is the right path and when a local Claude-compatible skill is a better fit

Acceptance criteria covered

  • README is current
  • CONTRIBUTING is current
  • at least one tutorial explains the dual-distribution model
  • contributor expectations are unambiguous
  • onboarding copy stays coherent after the distribution expansion

Validation

  • npm run check:mcp-distributions
  • npm run build

Notes

Refs: #13

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