skills.rest
BAIZ1D
BAIZ1DCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

writing-skills

Create compliant agent skills using standardized templates and TDD-based testing.

Updated Jun 30, 2026
Search Tags:#skill creation#agent skills#skill authoring#cso#skill testing#anti-rationalization#skill compliance
One-click install
npx skills add https://github.com/BAIZ1D/macbookM1_rice --skill writing-skills-baiz1d
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/BAIZ1D/macbookM1_rice/tree/main/agent/skills/writing-skills
Command: npx skills add https://github.com/BAIZ1D/macbookM1_rice --skill writing-skills-baiz1d

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill solves the problem of inconsistent, hard-to-discover, and non-compliant agent skills that fail to work as intended in real-world workflows, by providing standardized templates, architecture guidelines, and authoring best practices for skill creators.

Core Features & Use Cases

  • Tiered Architecture Guidance: Choose the right skill structure (Tier 1 simple, Tier 2 expanded, Tier 3 platform) based on your skill's complexity and scope.
  • Templates for All Skill Types: Copy-paste templates for technique, reference, discipline, and pattern skills to ensure consistent structure and compliance.
  • Compliance & Testing Guides: Resources for Claude Search Optimization (CSO) to improve skill discoverability, anti-rationalization techniques for discipline-enforcing skills, and TDD-based testing workflows to verify skills work under agent pressure.
  • Common Pitfalls Reference: A curated list of gotchas and mistakes to avoid when authoring skills, saving you hours of trial and error. A common use case is building a skill to enforce test-driven development for an engineering team: use this Skill to select the correct discipline skill template, add anti-rationalization counters for common excuses, and test it with pressure scenarios to ensure compliance.

Quick Start

Use the writing-skills skill to create a new compliant agent skill for your team's code review workflow, following the provided templates and standards.

Frequently Asked Questions about writing-skills

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create agent skills that are compliant and discoverable in real-world workflows?▼

To create compliant and discoverable agent skills, use standardized templates and architecture guidelines that ensure consistent metadata and progressive disclosure structure. This eliminates inconsistent, non-discoverable skills that fail under real-world agent pressure.

What is the best way to enforce test-driven development rules using agent skills?▼

The best way to enforce test-driven development is by selecting a discipline skill template and adding anti-rationalization counters for common excuses. You then test the skill with pressure scenarios to ensure strict compliance during engineering workflows.

How do I structure agent skills for different levels of complexity?▼

Structure agent skills using a tiered architecture: Tier 1 for simple skills, Tier 2 for expanded capabilities, and Tier 3 for platform-level scope. Choosing the correct tier ensures your skill matches its intended complexity and operational scope.

Can I use Claude Search Optimization to improve skill discoverability for my team?▼

Yes, you can apply Claude Search Optimization (CSO) resources to improve agent skill discoverability. CSO is integrated into the compliance and testing guides to help your team find and utilize custom capabilities effectively.

Why do my custom agent skills fail to work as intended under real-world pressure?▼

Custom agent skills fail under real-world pressure due to inconsistent structure and a lack of TDD-based testing workflows. Applying authoring best practices and testing skills with pressure scenarios verifies they work as intended.

What are the common pitfalls to avoid when authoring agent skills?▼

Common pitfalls when authoring agent skills include inconsistent structure, poor discoverability, and non-compliant metadata. Reviewing a curated list of gotchas and mistakes helps you avoid hours of trial and error during skill creation.

Related Skills

Explore More Software Engineering Skills→
emellebyemelleby

skill-creator

Design, document, and package Claude skills with SKILL.md frontmatter.

Community
Intermediate
nimeshgurungnimeshgurung

testing-skills-with-subagents

Apply the TDD cycle to test and refine AI agent skills.

Community
Advanced
aman-2709aman-2709
12

writing-skills

Apply test-driven development to author and verify SKILL.md files.

Community
Advanced
d3mingd3ming

skill-author

Create and update shared SKILL.md definitions for Codex and Claude agents.

Community
Intermediate