writing-skills incorrectly claims only two frontmatter fields are supported

[rsclafani]

• I searched existing issues and this is not a duplicate

Environment

Field	Value
Superpowers version	5.0.5
Harness (Claude Code, Cursor, etc.)	Claude Code
Harness version	Current
Model	Claude Opus 4.6
OS + shell	Linux / bash

Is this a Superpowers issue or a platform issue?

• I confirmed this issue does not occur without Superpowers installed

This is a Superpowers documentation issue — the writing-skills skill teaches incorrect information about Claude Code's supported frontmatter fields, causing Claude to produce skills with incomplete frontmatter.

What happened?

skills/writing-skills/SKILL.md (line 96) states:

Frontmatter (YAML):

• Only two fields supported: name and description

And skills/writing-skills/anthropic-best-practices.md (line 147) states:

YAML Frontmatter: The SKILL.md frontmatter supports two fields:

• name - Human-readable name of the Skill (64 characters maximum)
• description - One-line description of what the Skill does and when to use it (1024 characters maximum)

Both are incorrect. Claude Code supports at least 11 frontmatter fields:

Field	Description
name	Skill identifier
description	When to use the skill
user-invocable	Whether the skill appears in the / menu
disable-model-invocation	Prevent auto-loading into context
allowed-tools	Tools allowed without permission prompts
argument-hint	Autocomplete hint for arguments
model	Model override for this skill
effort	Effort level (low/medium/high/max)
context	Set to fork for subagent execution
agent	Subagent type when context: fork
hooks	Lifecycle hooks scoped to this skill

These are documented in the official Claude Code skills docs, Anthropic's Complete Guide to Building Skills for Claude, and the official skill-development plugin.

Steps to reproduce

1. Install superpowers plugin in Claude Code
2. Ask Claude to create a new skill using writing-skills
3. Claude produces a skill with only name and description in frontmatter, missing useful fields like allowed-tools, user-invocable, and disable-model-invocation

Expected behavior

The writing-skills skill should document all supported Claude Code frontmatter fields so that Claude produces skills with complete, correct frontmatter.

Actual behavior

Because writing-skills is the skill that teaches Claude how to write other skills, the incorrect "two fields only" claim propagates — Claude follows it literally and omits all optional frontmatter fields.

Suggested fix

Option A (minimal): Remove the specific field enumeration from both files and link to the official docs instead:

For supported frontmatter fields, see the [official Claude Code skills documentation](https://code.claude.com/docs/en/skills).

Option B (comprehensive): Replace the "two fields" claim with a table of all supported fields in both SKILL.md and anthropic-best-practices.md.

Option A is probably better since the official docs will stay current as new fields are added.

Files affected

• skills/writing-skills/SKILL.md line 96
• skills/writing-skills/anthropic-best-practices.md line 147

[arittr]

the fix for this will be in an upcoming release - thanks!