AI Feature Spec Writer

What this skill does

This skill writes a complete product and engineering spec for an AI-powered feature. Unlike a standard feature spec, AI features require additional sections: model selection rationale, prompt strategy, fallback behavior when the model produces bad output, latency and cost budgets, evaluation criteria, and a plan for handling model updates. The output is a spec detailed enough to guide implementation and evaluation without requiring additional design sessions.

Use this before building any feature that incorporates an LLM, image model, or other AI component — especially when the feature will be customer-facing or when the output quality directly affects the user experience.

How to use

Claude Code / Cline

Copy this file to .agents/skills/ai-feature-spec-writer/SKILL.md in your project root.

Then ask:

• "Use the AI Feature Spec Writer skill to write a spec for our AI-powered email drafting feature."
• "Write a product spec for adding AI summarization to our dashboard using the AI Feature Spec Writer skill."