writing-skills

Creates, edits, and verifies process-writing skills with YAML frontmatter and Markdown bodies.

1|Updated Dec 25, 2017
One-click install
npx skills add https://github.com/mattniedelman/dotfiles --skill writing-skills-mattniedelman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/mattniedelman/dotfiles/tree/main/dot_augment/skills/writing-skills
Command: npx skills add https://github.com/mattniedelman/dotfiles --skill writing-skills-mattniedelman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams codify and standardize the creation, editing, and verification of process-writing skills using a test-driven approach, turning tacit knowledge into repeatable documentation.

Core Features & Use Cases

  • Guided Skill Creation: Provides a structured template to define a new skill with a YAML frontmatter containing name and description.
  • Verification & Validation: Encourages baselining with failing tests and red-green-refactor workflow to ensure the skill improves behavior before deployment.
  • Documentation Quality Control: Enforces clear sections, targets, and constraints to maintain consistent quality across skills.

Quick Start

Use the writing-skills skill to structure a new skill document: define the YAML frontmatter with name and description, then write a minimal Markdown body that follows the frontmatter.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I turn tacit process knowledge into testable documentation?

To turn tacit process knowledge into testable documentation, use a test-driven approach that enforces YAML frontmatter with name and description, paired with a Markdown body for context activation. This standardizes process guides before team deployment.

How do I structure a new skill using YAML frontmatter and Markdown?

Structuring a new skill requires defining YAML frontmatter containing name and description, followed by a minimal Markdown body. This format ensures the skill document loads properly into context for activation across standardized process workflows.

Can I use test-driven development to verify process documentation before deployment?

Yes, you can verify process documentation using a test-driven development workflow. By baselining with failing tests and applying a red-green-refactor cycle, you ensure the skill improves behavior before deployment.

What is the best way to standardize process-writing skills across a team?

The best way to standardize process-writing skills is enforcing documentation quality control through clear sections, targets, and constraints. This maintains consistent quality by turning tacit knowledge into repeatable documentation.

Do I need specific dependencies to create and edit process-writing skills?

No specific dependencies are required to create and edit process-writing skills. The skill operates independently using a structured template of YAML frontmatter and Markdown body to codify and verify process documentation.