new-spec

Generate and reformat AI agent specifications using RFC 2119 requirement language.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/macintacos/dotfiles --skill new-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: new-spec
Source: https://github.com/macintacos/dotfiles/tree/main/managed/private_dot_claude/skills/new-spec
Command: npx skills add https://github.com/macintacos/dotfiles --skill new-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill standardizes the creation and reformatting of AI agent specifications (rules, skills, commands) by enforcing the use of precise requirement language.

Core Features & Use Cases

  • Standardized Specification Writing: Ensures all AI specifications use RFC 2119 keywords (MUST, SHOULD, MAY) for clarity and consistency.
  • Flexible Mode Operation: Supports both creating new specifications from scratch and reformatting existing documents.
  • Use Case: When developing a new AI skill, use this to draft its SKILL.md file, ensuring all functional requirements are clearly defined using RFC 2119.

Quick Start

Use the new-spec skill to create a new skill specification for an AI agent.

Frequently Asked Questions about new-spec

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

FAQPage Schema
How do I write an AI agent specification using RFC 2119?

To write an AI agent specification using RFC 2119, define functional requirements for rules and skills by applying keywords like MUST, SHOULD, and MAY to enforce precise semantic clarity. This standardizes the specification document.

What is the best way to format existing AI skill definitions for consistency?

The best way to format existing AI skill definitions is to reformat the document using RFC 2119 requirement language. This process enforces precise semantic requirements and ensures functional rules are clearly defined.

Why use RFC 2119 keywords in AI rule writing?

Use RFC 2119 keywords in AI rule writing to solve the problem of ambiguous instructions. Enforcing terms like MUST and SHOULD guarantees standardized specification writing, providing clarity and consistency for agent commands.

Can I generate a new skill specification from a text description?

Yes, you can generate a new skill specification from a text description. The system supports flexible mode operation, allowing you to create new agent documents from scratch while enforcing specific file structures for discoverability.

What file structure is required for AI agent specifications?

AI agent specifications require adherence to specific file structures and formatting guidelines, such as drafting a SKILL.md file. This structure ensures defined rules, skills, and commands maintain clarity and discoverability.