skills.rest
christhz666
christhz666COMMUNITY
Explore all skills by this author →
GitHub

writing-skills

Guide TDD-based development and testing of AI agent skills.

Updated Feb 26, 2026
Search Tags:#tdd#skill-creation#skill-testing#skill-optimization#ai-skills
One-click install
npx skills add https://github.com/christhz666/centro-diagnostico-v11 --skill writing-skills-christhz666
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/christhz666/centro-diagnostico-v11/tree/main/.skills/writing-skills
Command: npx skills add https://github.com/christhz666/centro-diagnostico-v11 --skill writing-skills-christhz666

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a structured approach for creating, testing, and maintaining AI agent skills, ensuring they are discoverable, efficient, and effective.

Core Features & Use Cases

  • Skill Creation: Offers guidelines for structuring SKILL.md files, including frontmatter and content structure.
  • Skill Testing: Describes the TDD-inspired process for testing skills to ensure they enforce desired behaviors and are resilient against rationalization.
  • Skill Optimization: Provides strategies for optimizing skill descriptions and content for efficient AI discovery and interaction.

Quick Start

To create a new skill, follow the TDD cycle: RED (baseline), GREEN (write skill), and REFACTOR (close loopholes).

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I test AI agent skills using TDD principles?▼

To test AI agent skills using TDD principles, follow the RED-GREEN-REFACTOR cycle: establish a baseline, write the skill to enforce desired behaviors, and refactor to close rationalization loopholes.

What is the best way to structure SKILL.md files for AI agent discoverability?▼

Structuring SKILL.md files for discoverability involves using proper YAML frontmatter and Markdown content organization to optimize descriptions, ensuring efficient AI interaction and skill discovery.

Do I need to know persuasion principles to create effective AI skills?▼

Yes, knowledge of persuasion principles is required alongside TDD methodologies to ensure the AI agent skills you create are effective, compliant, and resilient against rationalization during execution.

How does Graphviz work with AI skill documentation?▼

Graphviz integrates with AI skill documentation by providing visualization capabilities for the Markdown and YAML structures, mapping out skill logic and dependencies to aid in development and optimization.

Why does my AI agent rationalize and ignore skill instructions?▼

AI agents rationalize and ignore skill instructions when loopholes exist in the content; applying the REFACTOR phase of the TDD process closes these gaps and enforces strict behavioral compliance.

Related Skills

Explore More Software Engineering Skills→
AvaTar-ArTsAvaTar-ArTs

writing-skills

Enforce YAML frontmatter validation and RED-GREEN-REFACTOR workflows for skill authoring.

Community
Intermediate
charly3pinscharly3pins
4

testing-skills-with-subagents

Test skills with subagents under pressure scenarios and log rationalizations.

Community
Basic
ddttomddttom

md-workflow

Create, edit, and lint Markdown files with YAML frontmatter awareness.

Community
Intermediate
wade56754wade56754

ai-ad-prompt-structurer

Structure AI prompts into standardized XML/JSON templates with constraints.

Community
Advanced