ai-md

Convert CLAUDE.md instructions into structured YAML frontmatter rules.

3|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/ravnhq/typescript-blueprint --skill ai-md-ravnhq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ai-md
Source: https://github.com/ravnhq/typescript-blueprint/tree/main/.cursor/skills/ai-md
Command: npx skills add https://github.com/ravnhq/typescript-blueprint --skill ai-md-ravnhq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

AI.MD provides a framework to convert human-written CLAUDE.md instructions into AI-native, structured labels that any model can execute reliably, reducing ambiguity and token waste.

Core Features & Use Cases

  • Atomic rule decomposition: transforms dense natural-language rules into individual labeled rules that are easy to verify across models.
  • Cross-model validation: supports testing and alignment across Claude, GPT, and other LLMs to ensure consistent behavior.
  • Safe, auditable workflows: includes frontmatter requirements, toxicity checks, and a staged conversion process from understanding to testing.

Quick Start

Distill your CLAUDE.md into AI-native structured rules using the AI.MD workflow and validate results with two different models.

Frequently Asked Questions about ai-md

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

FAQPage Schema
How do I convert CLAUDE.md instructions into a structured AI-native format?

Converting CLAUDE.md into an AI-native format requires decomposing dense natural-language rules into atomic labeled rules, applying YAML frontmatter, and structuring instructions for token efficiency and reliable AI execution.

What is atomic rule extraction for prompt engineering?

Atomic rule extraction is a prompt engineering technique that transforms dense natural-language instructions into individual, labeled rules, making them easy to verify and validate consistently across different LLMs.

Does multi-model validation work with GPT and Claude system instructions?

Multi-model validation works with GPT and Claude by testing the converted structured instructions across models to ensure consistent behavior, alignment, and reliable cross-model execution.

When do I need YAML frontmatter and toxicity checks for system instructions?

You need YAML frontmatter and toxicity checks when migrating system instructions to ensure safe, auditable AI workflows, requiring explicit naming, descriptions, and safety-conscious component structuring.

What is the best way to reduce token waste in AI system instructions?

The best way to reduce token waste is converting human-written CLAUDE.md into AI-native structured labels, which eliminates ambiguity and ensures any model can execute the instructions reliably without excess tokens.