Marcos Paulo
d234f40134
Two unrelated cleanups from the 14-17 wave.
The review desk footer told visitors to mirror entries into catalog.js
'until task 16 rewires the page to read the collection'. Introduced by
b484302 (task 06), it shipped in the built HTML. The mirroring advice is
still correct -- verify.mjs:24,52,54 confirm the desk reads catalog.js --
so only the internal task reference is dropped.
.prettierignore now covers the legacy sources. They have very long lines,
so lint-staged re-wraps them wholesale as soon as an agent stages one:
task 15 added four lines to app.js and produced an 829-line diff. Paths
are root-anchored so a bare 'rules' does not swallow .agents/rules/.
53 lines
1.8 KiB
Plaintext
53 lines
1.8 KiB
Plaintext
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
|
|
which the desk still reads), then run
|
|
node scripts/build-skill-review.mjs
|
|
. Votes call a separate service — see
|
|
vote-service/
|
|
— one per visitor, tracked by network source.
|