docs: document all agentskills.io frontmatter fields in writing-skills#1001
Closed
lucianghinda wants to merge 21 commits into
Closed
docs: document all agentskills.io frontmatter fields in writing-skills#1001lucianghinda wants to merge 21 commits into
lucianghinda wants to merge 21 commits into
Conversation
I made Jesse's name more explicit as the original repo is created and maintained by them so the sponsorship should go there.
Updated description and body guidelines for clarity regarding Ruby developers.
Ports the compound skill from EveryInc/compound-engineering-plugin, adapted to superpowers-ruby conventions: fixed frontmatter (name, description-only), CSO-compliant description, standard section structure, and compressed from 1901 to 690 words. Includes a skill-triggering test prompt. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Add superpowers:compound skill for documenting solved problems
…ctions
- Rewrite description to be trigger-first and CSO-compliant ("Use when...")
instead of leading with a content summary
- Add Overview section explaining the skill covers patterns agents miss
by default (Weirich convention, nil-safe memoization, etc.)
- Add Common Mistakes table: raise vs fail, ||= nil caveat, += vs <<,
rescue Exception, deep &. chains, frozen_string_literal
- Add skill-triggering test prompt (raise vs fail question — confirmed
by subagent test to discriminate skill-loaded vs memory-only answers)
- Register ruby in tests/skill-triggering/run-all.sh
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Improve ruby skill: CSO description, Overview, and Common Mistakes se…
All skill names now use the superpowers-ruby: prefix instead of superpowers: to match the plugin name and avoid ambiguity when multiple superpowers plugins are installed side by side. - Rename superpowers:compound → superpowers-ruby:compound - Rename superpowers:compound-refresh → superpowers-ruby:compound-refresh - Move skill dirs: superpowers-compound/ → compound/, superpowers-compound-refresh/ → compound-refresh/ - Update session-start hook context message to reference superpowers-ruby:using-superpowers - Add full Skills Catalog table to using-superpowers skill so Claude always has the index in context at session start - Bump version to 6.0.0 across all plugin manifests and install docs BREAKING CHANGE: Any project pinning superpowers:compound or superpowers:compound-refresh by name must update to the superpowers-ruby: prefix. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Users upgrading from v5 need to reinstall the plugin to pick up the renamed skill directories, and update any direct references from superpowers: to superpowers-ruby: prefix. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Follows the namespace rename from v6.0.0. Tests that assert or invoke skills by name would fail against the new skill names. Left tests/opencode/test-priority.sh unchanged — its superpowers: references test OpenCode's own namespace resolution system, not our skill names. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Rename skill namespaces to superpowers-ruby: prefix and bump to v6.0.0
fix: correct plugin uninstall/install commands in changelog
Add license, compatibility, metadata, and allowed-tools fields to the skill frontmatter documentation. Previously only name and description were documented, omitting the optional fields supported by the spec. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Author
|
Sorry I mistakenly made a commit here but it should have been for my own fork |
5 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The
writing-skillsskill said onlynameanddescriptionwere supported in SKILL.md frontmatter. The agentskills.io spec supports 4 more optional fields — this PR documents them.Changes
SKILL.mdandanthropic-best-practices.md: replace "only two fields" with a full field table (license,compatibility,metadata,allowed-tools)nameto lowercase (spec requires it)6.0.1🤖 Generated with Claude Code