writing-skills

Standardize reusable agent skills with YAML frontmatter and validation checklists.

28|2|Updated May 4, 2026
One-click install
npx skills add https://github.com/xiaohei-info/oh-my-agent-skills --skill writing-skills-xiaohei-info
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/xiaohei-info/oh-my-agent-skills/tree/main/skills/skill-engineering/writing-skills
Command: npx skills add https://github.com/xiaohei-info/oh-my-agent-skills --skill writing-skills-xiaohei-info

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses the lack of consistency and reusability in agent workflows by providing a structured framework for creating, revising, and validating high-quality skills.

Core Features & Use Cases

  • Standardized Authoring: Provides a clear template and set of rules for writing reusable procedural memory.
  • Quality Validation: Includes a checklist to ensure skills are discoverable, actionable, and free of session-specific clutter.
  • Use Case: Use this skill when you have developed a successful workflow for a recurring task and want to convert it into a permanent, reliable skill that future agent sessions can load and execute effectively.

Quick Start

Use the writing-skills framework to review and refine the draft of my new skill documentation for clarity and reusability.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I standardize agent workflows for recurring tasks?

To standardize agent workflows, you convert recurring tasks into reusable procedural memory using defined design rules and YAML frontmatter structures. This ensures future agent sessions can reliably discover and execute the standardized skills.

What is the best way to write reusable agent skills?

The best way to write reusable agent skills is to apply a structured framework with specific design rules and validation checklists. This process guarantees the documentation remains actionable and free of session-specific clutter.

How do I validate if my agent skills are discoverable and actionable?

You validate discoverability and actionability by checking the documentation against a validation checklist. This ensures clear trigger-condition documentation and proper YAML frontmatter structures are present for agent execution.

Do I need YAML frontmatter to create standardized agent skills?

Yes, you need specific YAML frontmatter structures to create standardized agent skills. Adhering to these defined structures is required to ensure proper agent discoverability and reliable procedural memory loading.

Why does my agent fail to load procedural memory for complex workflows?

Agent procedural memory fails to load when skill documentation lacks clear trigger conditions or proper standardization. Applying defined design rules and YAML frontmatter structures ensures the agent can correctly discover and execute complex workflows.

Can I convert a successful workflow into a permanent agent skill?

Yes, you can convert a successful workflow into a permanent agent skill by using a standardization framework. This process transforms the workflow into reliable procedural memory with clear trigger conditions for future sessions.