skill-authoringlisted

# Skill authoring Produce a portable skill that installs cleanly into Jcode, Claude Code, Codex, Windsurf, Cursor, and opencode from this single repo. ## When to use - Creating a new skill or restructuring an existing one. - A skill exists but the agent never invokes it (description problem). - Installing or uninstalling skills across agent homes. Do not use this when the task is ordinary coding with no skill artifact involved. ## Workflow 1. **Scaffold.** ```bash python3 scripts/new_skill.py <skill-name> "When the user wants ..." ``` 2. **Write the description first.** It is the only text most agents see when deciding whether to load the skill. Format: `When the user wants <goal>. Also use when the user mentions "<phrase>", "<phrase>".` Include the words a user would actually type. 3. **Write the body.** Sections: purpose, when to use (plus a negative case), numbered workflow, hard rules, references. Commands beat prose. Keep it under ~500 lines and move depth into `references/`, mentioning each file by name so it is discoverable. 4. **Validate.** ```bash python3 scripts/validate.py ``` 5. **Install and verify.** ```bash python3 scripts/install.py --all --force python3 scripts/install.py --list ``` Confirm the symlink resolves back to this repo, then start a fresh agent session and check the skill appears. 6. **Commit.** One skill per commit where practical. ## Rules - `name` must be kebab-case and identical to