skills.rest
AI-Driven-Highspeed-Development
AI-Driven-Highspeed-DevelopmentOFFICIAL
Explore all skills by this author →
GitHub

writing-instructions

Create and validate .instructions.md files with YAML frontmatter and standardized sections.

Updated Feb 1, 2026
Search Tags:#automation#workflow#templates#markdown#validation#instructions#frontmatter
One-click install
npx skills add https://github.com/AI-Driven-Highspeed-Development/adhd_framework_v3 --skill writing-instructions
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-instructions
Source: https://github.com/AI-Driven-Highspeed-Development/adhd_framework_v3/tree/main/modules/dev/instruction_core/data/skills/writing-instructions
Command: npx skills add https://github.com/AI-Driven-Highspeed-Development/adhd_framework_v3 --skill writing-instructions

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

Streamlines the creation and maintenance of .instructions.md files by prescribing a strict frontmatter contract, a standardized section structure, and reusable templates to ensure machine-enforceable rules and consistent guidance across skills.

Core Features & Use Cases

  • Defines a precise YAML frontmatter with an applyTo pattern to automatically activate rules for target files.
  • Provides a complete instruction template with Goals, Rules, and Examples to ensure verifiable, actionable guidance.
  • Enables reuse across modules by standardizing naming conventions, file locations, and validation steps.

Quick Start

Create or update an .instructions.md file by following the authoring SOP and using the provided templates for the YAML header, goals, rules, and examples.

Frequently Asked Questions about writing-instructions

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

FAQPage Schema
How do I create machine-loadable markdown instruction files with YAML frontmatter?▼

To create machine-loadable markdown instruction files, author an .instructions.md file using a strict YAML frontmatter contract and mandated sections like Goals, Rules, and Examples. This standardization enforces verifiable, automated guidance across modules.

What is the required structure for an .instructions.md file to ensure automated validation?▼

The required structure for an .instructions.md file includes a valid YAML frontmatter header, followed by mandated sections: Title, Goals, Rules, and Template or Examples. This canonical layout ensures machine-enforceable rules and consistent guidance.

How do I automatically apply markdown instruction rules to specific target files?▼

You automatically apply markdown instruction rules by defining an applyTo pattern within the YAML frontmatter of your .instructions.md file. This pattern targets specific files, activating the prescribed rules automatically during module development workflows.

How do I standardize instruction templates for reuse across multiple development modules?▼

You standardize instruction templates for reuse by enforcing canonical naming conventions, file locations, and validation steps across your project. Using a formal authoring SOP ensures the templates remain consistent and verifiable across multiple skills and modules.

What are the limitations of using standardized markdown instructions for workflow automation?▼

A limitation of using standardized markdown instructions is the strict reliance on valid YAML frontmatter and mandated sections. Any deviation from the formal section structure or frontmatter contract breaks the machine-loadable validation and automated rule application.

Do I need specific dependencies to validate YAML frontmatter in markdown instruction files?▼

No specific external dependencies are required to validate YAML frontmatter in markdown instruction files. The validation process relies on enforcing the internal formal YAML header contract and standardized section structure directly within your module development workflow.

Related Skills

Explore More Software Engineering Skills→
tailcallhqtailcallhq
7.5k

create-agent

Generate standardized Forge agent files with YAML frontmatter and markdown bodies.

Official
Advanced
theodorosploumistheodorosploumis
34

Drupal Config Parser

Parse and validate Drupal configuration YAML files for best-practices compliance.

Community
Intermediate
pr-pmpr-pm
121

creating-copilot-packages

Create GitHub Copilot instruction packages with repository-wide Markdown and path-specific YAML frontmatter.

Community
Basic
nuxt-contentnuxt-content
2.9k

review-docs

Audit documentation quality across Docus, Nuxt Content, and Markdown projects.

Official
Advanced