plugin-marketplace-setup
Plugin & skill marketplace setup
Ship skills (portable instructions), plugins (runtime wiring), and marketplaces (catalogs) without mixing them up.
Three layers (normative)
| Layer | What it is | Install unit | Skill Steward home |
|---|---|---|---|
| Skill | SKILL.md per agentskills.io |
npx skills add owner/repo --skill name |
skills/{name}/ |
| Plugin | Manifest + hooks/MCP/rules/commands | Per-agent (see matrix) | plugins/{id}/ (ADR 0004) |
| Marketplace | Catalog of plugins/skills | Add marketplace, then install plugin | Product repos; Guild uses public Git + skills.sh |
Rule: Instructions only → skill. Event hooks or multi-file wiring → plugin (references skills by id, do not fork SKILL.md).
Public vs private (decision)
More from arenukvern/skill_steward
adr-records
Writes and maintains ADRs (MADR, Nygard, Y-Statement) and runs decision checkpoints before/during work—trigger matrix, option briefs, proposed ADRs. Use when creating or updating ADRs, facing a design fork, trade-off, boundary change, or when the user asks for key design decisions before implementing.
1faq-driven-docs
Creates and maintains DESIGN_FAQ (why) and DX_FAQ (how) documentation in FAQ-driven development style. Use when writing docs, rules, prompts, updating FAQs after code changes, or bootstrapping faq_usage rules and Cursor commands.
1create-skill
Scaffold a new Agent Skill in this marketplace repo with valid SKILL.md, directory layout, and registry entries. Use when adding a skill, creating SKILL.md, or contributing to skill_steward.
1skill-source-citations
Requires durable citations when authoring or researching Agent Skills—maintain references/sources.md per skill, link external research, and record provenance in PRs. Use when creating skills, updating SKILL.md, doing web research for skills, or auditing missing sources.
1skill-spec-review
Audit SKILL.md and skill directories for Agent Skills spec, Cursor extensions, and npx skills compatibility. Use when reviewing a skill, validating frontmatter, or checking marketplace readiness.
1concept-doc-store
Bootstraps and maintains a vectorless, layered documentation store for concepts, architecture, and decisions—without duplicating how code works. Use when organizing repo docs, writing ADRs, north-star charters, agent playbooks, or product-style doc lattices.
1