write-skill

Enforce standardized SKILL.md structure with YAML frontmatter and defined sections.

Updated Mar 20, 2026
One-click install
npx skills add https://github.com/developer239/marek-opencode --skill write-skill-developer239
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-skill
Source: https://github.com/developer239/marek-opencode/tree/main/src/skills/write-skill
Command: npx skills add https://github.com/developer239/marek-opencode --skill write-skill-developer239

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Conventions for authoring SKILL.md files provide a standardized template and rules, ensuring all skills follow a uniform frontmatter and section layout to improve discoverability and consistency.

Core Features & Use Cases

  • Defines required frontmatter fields (name, description) and optional last_verified.
  • Specifies section structure (Purpose, Core Rules, Detailed Sections, Anti-Patterns, Rules) and gate patterns (Applicability, Monorepo Addendum) to guide skill authors.
  • Serves as a compliance reference to keep all SKILL.md documentation cohesive across the repository.

Quick Start

Write a new SKILL.md following this standard before authoring or reviewing any skill.

Frequently Asked Questions about write-skill

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

FAQPage Schema
How do I enforce consistent markdown documentation and frontmatter across repository files?

To enforce consistent markdown documentation and frontmatter, apply standardized SKILL.md conventions that require YAML frontmatter with name and description fields, ensuring uniform structure and discoverability across all files.

What is the required YAML frontmatter structure for skill documentation?

The required YAML frontmatter structure for skill documentation mandates a name and description field, while also supporting an optional last_verified field to track validation status across the repository.

How do I organize sections when writing a new SKILL.md file?

To organize sections when writing a SKILL.md file, follow the mandated three-section structure: Purpose, Core Rules, and Detailed Sections, while applying gate patterns like Applicability and Monorepo Addendum to guide content organization.

Do I need any external dependencies to standardize my markdown templates?

You do not need any external dependencies to standardize your markdown templates, as the skill operates with zero dependencies to validate frontmatter and enforce section organization rules directly.

What anti-patterns should I avoid when authoring markdown documentation?

When authoring markdown documentation, avoid anti-patterns by ensuring you do not omit required frontmatter fields, deviate from the defined section structure, or bypass gate patterns that maintain documentation consistency.