40 lines
2.0 KiB
Markdown
40 lines
2.0 KiB
Markdown
# Release v4.2.0: Writing Skills Gold Standard Architecture
|
||
|
||
> **Complete refactor of the writing-skills skill to Cloudflare Gold Standard architecture for modular, discoverable skill creation excellence**
|
||
|
||
This release modernizes the core skill-creation skill with a modular architecture inspired by Cloudflare's documentation patterns. The refactored writing-skills now offers progressive disclosure, decision trees, and dedicated reference modules for CSO, anti-rationalization, testing, and tier-based skill structures.
|
||
|
||
## 🚀 Improvements
|
||
|
||
### 📝 [writing-skills](skills/writing-skills/) – Gold Standard Refactor
|
||
|
||
**Modular architecture for skill creation excellence**
|
||
|
||
The writing-skills skill has been completely refactored to align with Cloudflare Gold Standard principles. Content is now organized into focused, navigable modules instead of a monolithic document.
|
||
|
||
- **Quick Decision Tree**: Start with "Create new" vs "Improve existing" vs "Verify compliance" to find the right path
|
||
- **Component Index**: Direct links to CSO (discovery), Standards (metadata), Anti-Rationalization (rules that stick), and Testing (TDD for skills)
|
||
- **Tier Architecture**: Tier 1 (simple, single file), Tier 2 (expanded, references/), Tier 3 (platform, multi-product)
|
||
- **Templates**: Technique, Reference, Discipline, and Pattern skill templates with clear structure
|
||
- **Gotchas & Examples**: New gotchas.md and examples.md for common pitfalls and copy-pasteable patterns
|
||
- **References Module**: Dedicated READMEs for anti-rationalization, CSO, standards, templates, testing, and tier guides
|
||
|
||
> **Try it:** `"I want to create a new skill"` or `"How do I fix a skill that agents ignore?"`
|
||
|
||
---
|
||
|
||
## 📦 Registry Update
|
||
|
||
- **Catalog**: Regenerated for 553 skills
|
||
- **Structure**: writing-skills now uses `references/` subdirectory with 12+ supporting documents
|
||
|
||
## 👥 Credits
|
||
|
||
A huge shoutout to our community contributors:
|
||
|
||
- **@evandro-miguel** for writing-skills Gold Standard refactor (PR #41)
|
||
|
||
---
|
||
|
||
_Upgrade now: `git pull origin main` to fetch the latest skills._
|