writing-skills

Create AI agent skill documentation with test-driven development and discovery optimization.

Updated Jul 2, 2026
One-click install
npx skills add https://github.com/tgmarinho/agent-super-powers-matt-pocock-skills-comparasions --skill writing-skills-tgmarinho
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/tgmarinho/agent-super-powers-matt-pocock-skills-comparasions/tree/main/upstream-snapshots/superpowers/skills/writing-skills
Command: npx skills add https://github.com/tgmarinho/agent-super-powers-matt-pocock-skills-comparasions --skill writing-skills-tgmarinho

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires superpowers:test-driven-development, and includes scripts (resource) and references (resource) components.

What problem does it solve?

The Writing Skills Skill solves the problem of inefficient skill development by promoting test-driven documentation, ensuring that documentation is thorough, accurate, and useful.

Core Features & Use Cases

  • Test-Driven Documentation: Develop skills with a focus on testing to ensure clarity and applicability.
  • Skill Authoring Best Practices: Provides guidelines for creating effective skills that agents can discover and use.
  • Skill Discovery Optimization (SDO): Enhances skill discoverability for agents by following best practices for description, naming, and structure.

Quick Start

Use the writing-skills skill to create a new skill for testing code review workflows.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
What is test-driven documentation for AI agent skills?

Test-driven documentation is a structured approach to skill authoring that emphasizes testing to ensure AI agent skill documentation is thorough, accurate, and useful before deployment. It enhances skill clarity and applicability through validated guidelines.

How do I create AI agent skills using test-driven development?

To create AI agent skills, use a structured approach that applies test-driven development principles to the authoring process. This involves developing skills with a focus on testing to ensure documentation accuracy and optimize the skill for agent discovery and use.

Does writing-skills require test-driven-development as a dependency?

Yes, the writing-skills skill depends on the test-driven-development superpowers component. This prerequisite ensures you have the foundational testing frameworks needed to implement test-driven documentation effectively during skill creation.

What is the best way to optimize AI agent skills for discovery?

The best way to optimize AI agent skills for discovery is by following skill discovery optimization practices, which provide guidelines for effective description, naming, and structure. This ensures agents can efficiently find and use the authored skills.

Why does my AI agent skill documentation lack clarity and applicability?

Skill documentation lacks clarity when not using test-driven development practices. Inefficient skill development leads to incomplete documentation, but applying test-driven documentation ensures guidelines are accurate, thorough, and useful for agent consumption.

Can I use writing-skills to create a skill for testing code review workflows?

Yes, you can use the writing-skills skill to create new skills for testing code review workflows. It provides the structured approach and best practices needed to author, test, and document skills for specific development processes.