Update Awesome List
Add or update entries in the current repo's awesome-skills.json, then regenerate the README awesome-list section.
Entry target
When the user gives a repo, do not assume the right recommendation unit. Inspect first, then ask whether they want:
- the whole repo as an entry
- one or more specific skills as entries
- a repo entry with highlighted skills
If the repo has many public skills, tell the user the exact count when available. If the count is greater than 12, tell the user it appears to be a broad-catalog repo and recommend adding specific skills, while still allowing:
- repo only
- repo with highlights
- specific skills only
Use natural-language narrowing when the user wants help selecting standout skills or highlights.
Inspect the repo with the bundled helper:
npx cyberplace@<version> awesome inspect owner/name
Narrow by query when needed:
npx cyberplace@<version> awesome inspect owner/name --query "release"
Editing rules
- Edit
awesome-skills.json. - Store repo recommendations under the top-level
reposobject, keyed by normalized repo id (owner/name). - Store skill recommendations under the top-level
skillsobject, keyed by canonical skill id (owner/name::skill-name). - Keep the embedded
repoandskillvalues consistent with the object key. - Store a neutral
summaryfor what the repo or skill does. - Store a separate
why_recommendednote for why the user or agent recommends it. - Keep tags short and lower-kebab-case.
- Repo entries may include typed
highlightsusing:
{
"type": "skill",
"key": "audit-skill",
"summary": "Audit SKILL.md structure, quality, and security.",
"why_recommended": "Strong review rubric before installing or publishing skills.",
"tags": ["audit", "security"]
}
Finish
After editing, regenerate the README bounded section so the human-facing list stays in sync with awesome-skills.json:
npx cyberplace@<version> awesome render