Submitted Skills — Review Desk
← field guide
SUBMITTED SKILLS / REVIEW DESK
submissions
A friendly path from draft to dependable
Every skill deserves
a clear job.
Read the original, understand what already works, and compare a safer, leaner draft. Nothing here overwrites a submission; revisions live in their own review output.
01
Discoverable
A precise description tells an agent when to load the skill.
02
Useful in context
Core workflow stays short; conditional detail loads only when needed.
03
Safe by design
Commands, secrets, and shared systems have explicit boundaries.
04
Proven in use
Real prompts and observable checks turn a draft into a reliable tool.
How to use this desk
Compare.
Then choose.
Select a submission, or open an author URL.
Read the gentle review before judging the draft.
Choose
Preview Markdown
in the file toolbar to render either version.
Copy or download the version you want, then vote for the draft you would ship.
The catalog
Find a skill
Why these reviews look this way
The recommendations follow the open Agent Skills format: valid frontmatter for discovery, progressive disclosure for context economy, deterministic scripts for fragile repeated mechanics, and behavioral evaluation rather than a checklist of pretty headings.
Format specification ↗
Writing practices ↗
Evaluation loop ↗
Scripts guide ↗
Share an author with
?author=Name
, or one review with
?author=Name&skill=skill-id&view=improved
. To add a submission later: drop a package under
submitted-skills/
, add an entry under
src/content/reviews/{new-id}.md
(and mirror it into
skills-review/catalog.js
until task 16 rewires the page to read the collection), then run
node scripts/build-skill-review.mjs
. Votes call a separate service — see
vote-service/
— one per visitor, tracked by network source.
