instruction-conventions

What problem does it solve?

Provides clear conventions and a ready template so instruction files are consistent, discoverable, and safe to inject into agent contexts, reducing broken or duplicate instructions across projects.

Core Features & Use Cases

• Template & Frontmatter: Specifies required YAML frontmatter fields such as name and description and recommends applyTo usage for automatic application.
• Location & Naming: Describes placement under ~/.agents/instructions and conventions for lowercase-hyphenated .instructions.md filenames.
• Content Guidance: Advises keeping instruction bodies short, prescriptive, and focused on rules rather than multi-step workflows to avoid redundancy with skills.

Quick Start

Create a new instruction file in your ~/.agents/instructions directory using the required frontmatter with name, description, and applyTo and write a concise, prescriptive body suitable for full-context injection.