john/claude-engineering-plugin
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(create-agent-skills): rewrite to match Anthropic official spec

Browse Source 
The previous version incorrectly recommended XML tags for skill body content.
Anthropic's official specification uses standard markdown headings.

Changes:
- SKILL.md: Complete rewrite using markdown format, not XML tags
- Added references/official-spec.md from code.claude.com/docs/en/skills
- Added references/best-practices.md from platform.claude.com
- Removed obsolete use-xml-tags.md
- Updated naming to gerund form (creating-agent-skills)
- Descriptions now third person with "what" and "when"

BREAKING: If you followed the old XML tag guidance, convert to markdown headings.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Kieran Klaassen
2026-01-01 21:38:53 -08:00
parent 14512fe980
commit 948fb4b984
6 changed files with 865 additions and 617 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
plugins/compound-engineering/CHANGELOG.md
View File

@@ -5,6 +5,24 @@ All notable changes to the compound-engineering plugin will be documented in thi
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [2.20.0] - 2026-01-01
### Changed
- **`create-agent-skills` skill** - Complete rewrite to match Anthropic's official skill specification:
- **Format change**: Skills now use standard markdown headings (`## Quick Start`, `## Instructions`), NOT XML tags. The previous version incorrectly recommended XML tags which is not the official format.
- **Naming convention**: Updated to use gerund form (`creating-agent-skills`, `processing-pdfs`) per official spec
- **Description format**: Must be third person, include both what and when to use
- Added `references/official-spec.md` - Anthropic's official skill specification from code.claude.com/docs/en/skills
- Added `references/best-practices.md` - Skill authoring best practices from platform.claude.com
- Removed obsolete `references/use-xml-tags.md` - this was incorrect guidance
### Philosophy
This update aligns the skill with Anthropic's official documentation. The key insight: **Skills are prompts**. All standard prompting best practices apply. Use standard markdown, not custom XML tags. Keep SKILL.md under 500 lines with progressive disclosure to reference files.
---
## [2.19.0] - 2025-12-31
### Added