Skill submission documents

July 7, 2026 · View on GitHub

Fill-in-the-blank templates for the documents every marketplace submission ships with. These are the single source of truth — external contributors and Intent Solutions' own skills use the same templates and are held to the same standard. Full process: 000-docs/700-DR-GUID-skill-submission-standard.md.

Which docs does my submission need?

The bar scales with the tier — a bigger claim carries more paperwork, not a bigger skill.

TierWhat it coversRequired docs
Micro-skilla single command or skill, no scriptsPRD.md (short form OK)
Standard pluginskills plus scripts/commandsPRD.md + ADR.md
Pack / flagship / featured / paid-tiermulti-skill packs, featured picks, anything soldPRD.md + ADR.md + ONE-PAGER.md (+ CFO-ONE-PAGER.md where money is the pitch)

The templates

TemplateWhat it proves
PRD.mdThe problem is real, the users exist, success is measurable
ADR.mdThe design was a decision, not an accident — including least-privilege tool scope
ONE-PAGER.mdAn installer-in-a-hurry can evaluate it from one screen
CFO-ONE-PAGER.mdThe money claim survives a skeptical reader (enterprise/flagship/paid only)

How to use them

  1. Open the submission issue first. The plugin-submission issue template captures the PRD-level answers (problem, users, success criteria, top requirements) before any code review happens. A PR without a linked submission issue will be asked to file one.
  2. Copy the templates your tier requires into your plugin directory as docs/PRD.md, docs/ADR.md, docs/ONE-PAGER.md, docs/CFO-ONE-PAGER.md.
  3. Fill them in and delete the italic instruction lines. Angle-bracket placeholders (<like this>) mark every blank.
  4. Link the issue from your PR (Closes #N or Refs #N) with the docs included.

Each template is deliberately short (under ~80 lines). If your filled-in version is shorter than the template, that's fine — completeness beats length, same as the rest of the marketplace bar.