skill-writing

Create, refine, or debug SKILL.md modules using a test-driven approach.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/kaissalha/webld --skill skill-writing-kaissalha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-writing
Source: https://github.com/kaissalha/webld/tree/main/.agents/skills/skill-writing
Command: npx skills add https://github.com/kaissalha/webld --skill skill-writing-kaissalha

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Skill Writing provides a structured, test-driven approach to creating, refactoring, and validating agent instruction modules (SKILL.md) so agents follow desired behavior with documented guardrails and rationalizations.

Core Features & Use Cases

  • TDD-driven skill creation: write a failing scenario, then implement and refactor for compliance.
  • Standardized frontmatter and prompts: ensure consistent loading and activation across projects.
  • Debug and optimize: improve prompt structure, descriptions, and rationale to reduce drift and misbehavior.
  • Use Cases: when you need to create a new skill, refine an existing one, or improve agent instruction compliance and test coverage.

Quick Start

Document and implement a test-driven skill for agent prompt formatting, starting from a failing scenario and iterating until the agent complies.

Frequently Asked Questions about skill-writing

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

FAQPage Schema
How do I write agent instructions that prevent prompt drift?

Prevent prompt drift by creating SKILL.md modules using a test-driven approach, writing a failing scenario first, then implementing and refactoring the agent instructions until compliance is achieved.

Why does my agent ignore instructions in my prompt?

Your agent might ignore instructions if the SKILL.md module lacks explicit guardrails and rationalizations; debugging and optimizing the prompt structure with a test-driven approach resolves this non-compliance.

What is test-driven development for AI agent skills?

Test-driven development for AI agent skills is a structured approach where you write a failing scenario first, then implement and refactor the SKILL.md module until the agent reliably follows the desired behavior with documented guardrails.

How do I structure a SKILL.md file for reliable prompt handling?

Structure a SKILL.md file by including frontmatter with a name and description, a concise operational description, and guardrails with explicit failure handling to ensure reliable prompt loading and activation across projects.

What's the best way to refactor existing agent instructions?

The best way to refactor existing agent instructions is to apply a test-driven approach: write failing scenarios for current behavior, then refine the SKILL.md prompt structure, descriptions, and rationale to improve compliance and test coverage.

Do I need guardrails for every agent instruction module?

Yes, you need guardrails with explicit failure handling for every agent instruction module to ensure reliable prompt handling, reduce misbehavior, and maintain consistent activation across projects.