skills.rest
intelligentcode-ai
intelligentcode-aiOFFICIAL
Explore all skills by this author →
GitHub

skill-writer

Author AI agent skills using a Test-Driven Development red-green-refactor cycle.

1|1|Updated Feb 6, 2026
Search Tags:#skill development#workflow#TDD#validation#authoring#meta
One-click install
npx skills add https://github.com/intelligentcode-ai/skills --skill skill-writer-intelligentcode-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-writer
Source: https://github.com/intelligentcode-ai/skills/tree/main/skills/skill-writer
Command: npx skills add https://github.com/intelligentcode-ai/skills --skill skill-writer-intelligentcode-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill streamlines the creation and refinement of AI agent skills by enforcing a Test-Driven Development (TDD) workflow, ensuring skills are robust, reliable, and precisely triggered.

Core Features & Use Cases

  • TDD Enforcement: Guides users through a red-green-refactor cycle for skill development.
  • Trigger Optimization: Helps refine skill descriptions for accurate and reliable activation.
  • Use Case: When you need to build a new skill for summarizing meeting transcripts, this skill will guide you to first write tests for what prompts should trigger it, then help you write the skill's SKILL.md to pass those tests.

Quick Start

Use the skill-writer to create a new skill for summarizing meeting notes, following a TDD approach.

Frequently Asked Questions about skill-writer

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

FAQPage Schema
How do I use TDD to create and validate AI agent skills?▼

TDD for AI agent skills involves writing trigger validation tests first, then authoring the skill content to pass them. This red-green-refactor cycle ensures reliable activation and high-quality deterministic instructions.

What is the best way to ensure my skill descriptions trigger accurately?▼

The best way to ensure accurate skill triggering is to refine descriptions through iterative test-driven validation. By testing specific prompts against the skill frontmatter, you can optimize activation reliability before deployment.

How do I structure reusable AI agent skills with progressive disclosure?▼

Structure reusable AI agent skills by defining clear frontmatter and deterministic instructions in the main file, then progressively disclosing detailed logic into associated script, reference, or asset files for maintainability.

Do I need prior test scripts to start authoring skills with a TDD workflow?▼

You do not need existing test scripts to start. The TDD workflow guides you through creating the initial trigger validation tests as the first step, ensuring the red-green-refactor cycle begins before the skill content is written.

What are the limitations of using a TDD approach for skill authoring?▼

A limitation of TDD for skill authoring is that it requires defining explicit trigger and quality tests upfront, which may restrict rapid prototyping for highly experimental or non-deterministic AI workflows before validation.

Related Skills

Explore More Software Engineering Skills→
XWIlluDeluXWIlluDelu

anthropic-skill-creator

Draft, evaluate, and optimize Claude Code skill instructions and triggers.

Community
Advanced
caobingshengcaobingsheng
1

skill-creator

Scaffold new Gemini Skill units with SKILL.md, scripts, references, and assets.

Community
Intermediate
LamseyahEliasLamseyahElias

hermes-agent-skill-authoring

Define in-repo Hermes-Agent skills with SKILL.md and YAML frontmatter.

Community
Intermediate
beyonaibeyonai
45

skill-optimizer

Optimize agent skill instructions through a validation-gated feedback loop.

Community
Advanced