When should I use this skill?

Use this skill whenever you are defining a task for an AI. It's ideal for creating system prompts, CLAUDE.md or AGENTS.md files, AI-targeted code comments, and architectural guides that you want an AI to follow with high fidelity.

What key capabilities does it provide?

It provides templates for creating structured instructions with XML tags like and , enforces positive and concrete commands, uses {placeholders} for dynamic content, and includes [Decision] markers for branching logic, making AI instructions explicit.

What does the AI Documentation skill do?

This skill provides a structured framework for writing documentation specifically for AI consumption. It uses XML tags, templates, and strict rules to create clear, machine-readable instructions, system prompts, and agent behavior guides.

How does this skill improve my workflow with Claude?

It significantly improves the reliability and predictability of AI outputs. By providing concrete, step-by-step workflows and explicit decision trees, you reduce ambiguity and ensure Claude performs coding and documentation tasks exactly as intended.

AI Documentation

Name: AI Documentation
Author: aster-void

byaster-void

0•

Learning & Documentation

Generates structured, machine-readable documentation optimized for AI consumption, including system prompts, agent instructions, and architectural guides.

Standardizes the creation of documentation specifically intended for AI agents like Claude. This skill moves away from prose and towards a structured, machine-followable format using XML tags, clear workflows, and concrete examples. By providing explicit rules, decision-making frameworks, and placeholder-driven templates, it enables AI to reliably understand and execute complex tasks within a repository. It is essential for authoring CLAUDE.md files, system prompts, or any documentation that guides an AI's behavior and operational logic.

Key Features

01Promotes positive, concrete, and observable instructions over vague or negative framing.

02Uses XML tags (<rules>, <workflow>) for structured, machine-readable instructions.

03Provides templates and specific guidelines for creating CLAUDE.md files, system prompts, and AI-targeted comments.

04Defines strict content and length constraints to ensure documentation remains concise and effective.

05Enforces step-by-step, followable workflows with decision branching ([Decision]) and placeholders ({placeholder}).

060 GitHub stars

Use Cases

01Creating a CLAUDE.md or AGENTS.md file to guide an AI assistant's behavior within a repository.

02Writing effective system prompts for AI agents that require complex, multi-step workflows.

03Documenting repository architecture and coding conventions for an AI pair programmer to understand and follow.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add aster-void/dotfiles ai-docs

For use in Claude.ai and ChatGPT

Download Skill