writing-skills

Guide AI skill creation, testing, and refinement with a TDD-inspired methodology.

3|1|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/jon23d/skillz --skill writing-skills-jon23d
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/jon23d/skillz/tree/main/skills/writing-skills
Command: npx skills add https://github.com/jon23d/skillz --skill writing-skills-jon23d

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a comprehensive guide and checklist for creating, testing, and refining AI skills, ensuring they are discoverable, efficient, and robust.

Core Features & Use Cases

  • Skill Creation Framework: Follows a RED-GREEN-REFACTOR methodology for iterative development.
  • Best Practices: Details on SKILL.md structure, description writing, formatting, and token efficiency.
  • Testing Strategies: Guidance on establishing baselines, writing minimal skills, and bulletproofing against rationalization.
  • Use Case: You need to create a new skill for your AI agent to manage GitHub pull requests. This skill will guide you through defining its purpose, writing the SKILL.md, implementing any necessary scripts, and thoroughly testing its behavior before deployment.

Quick Start

Use the writing-skills skill to follow the checklist for creating a new skill.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I create and test AI skills for an AI agent?

Establish testing baselines for AI skills by writing minimal skills and bulletproofing them against rationalization. This approach closes loopholes and ensures robust behavior before deployment.

What are best practices for writing SKILL.md descriptions?

Structure SKILL.md files for AI agents by following specific best practices for formatting and token efficiency. Proper structure ensures the skill is discoverable and operates efficiently during interactions.

How do I establish a testing baseline for an AI skill?

Establish testing baselines for AI skills by writing minimal skills and bulletproofing them against rationalization. This approach closes loopholes and ensures robust behavior before deployment.

What is the best way to structure AI skills for discoverability and efficiency?

Structure AI skills for discoverability and efficiency by following a TDD-inspired checklist for creation and refinement. This methodology focuses on optimal SKILL.md formatting and token efficiency to ensure robust agent interactions.

When should I use a TDD-inspired methodology for AI skill development?

Use a TDD-inspired methodology for AI skill development when you need to iteratively create, test, and refine skills. It provides a comprehensive guide and checklist ensuring your skills are robust and bulletproofed against rationalization.