v3.1.0 (2025-10-17)

Breaking Changes

Skill names standardized to lowercase

• All skill frontmatter name: fields now use lowercase kebab-case matching directory names
• Examples: brainstorming, test-driven-development, using-git-worktrees
• All skill announcements and cross-references updated to lowercase format
• This ensures consistent naming across directory names, frontmatter, and documentation

New Features

Enhanced brainstorming skill

• Added Quick Reference table showing phases, activities, and tool usage
• Added copyable workflow checklist for tracking progress
• Added decision flowchart for when to revisit earlier phases
• Added comprehensive AskUserQuestion tool guidance with concrete examples
• Added "Question Patterns" section explaining when to use structured vs open-ended questions
• Restructured Key Principles as scannable table

Anthropic best practices integration

• Added skills/writing-skills/anthropic-best-practices.md - Official Anthropic skill authoring guide
• Referenced in writing-skills SKILL.md for comprehensive guidance
• Provides patterns for progressive disclosure, workflows, and evaluation

Improvements

Skill cross-reference clarity

• All skill references now use explicit requirement markers:
  • **REQUIRED BACKGROUND:** - Prerequisites you must understand
  • **REQUIRED SUB-SKILL:** - Skills that must be used in workflow
  • **Complementary skills:** - Optional but helpful related skills
• Removed old path format (skills/collaboration/X → just X)
• Updated Integration sections with categorized relationships (Required vs Complementary)
• Updated cross-reference documentation with best practices

Alignment with Anthropic best practices

• Fixed description grammar and voice (fully third-person)
• Added Quick Reference tables for scanning
• Added workflow checklists Claude can copy and track
• Appropriate use of flowcharts for non-obvious decision points
• Improved scannable table formats
• All skills well under 500-line recommendation

Bug Fixes

• Re-added missing command redirects - Restored commands/brainstorm.md and commands/write-plan.md that were accidentally removed in v3.0 migration
• Fixed defense-in-depth name mismatch (was Defense-in-Depth-Validation)
• Fixed receiving-code-review name mismatch (was Code-Review-Reception)
• Fixed commands/brainstorm.md reference to correct skill name
• Removed references to non-existent related skills

Documentation

writing-skills improvements

• Updated cross-referencing guidance with explicit requirement markers
• Added reference to Anthropic's official best practices
• Improved examples showing proper skill reference format