skills.rest
richard-jh-mccrae
richard-jh-mccraeCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

writing-great-skills

Provides vocabulary and principles for writing predictable, well-structured skills.

Updated Jun 25, 2026
Search Tags:#documentation#codex#prompt design#skill authoring#frontmatter#skill.md#agent instructions
One-click install
npx skills add https://github.com/richard-jh-mccrae/PokemonAI --skill writing-great-skills-richard-jh-mccrae
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-great-skills
Source: https://github.com/richard-jh-mccrae/PokemonAI/tree/main/.agents/skills/writing-great-skills
Command: npx skills add https://github.com/richard-jh-mccrae/PokemonAI --skill writing-great-skills-richard-jh-mccrae

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Authors of AI skills often produce inconsistent, unpredictable instructions because they lack a shared vocabulary and set of principles for skill design. This Skill supplies a reference workflow for writing and editing skills so their behavior is predictable when loaded by an agent. ## Core Features & Use Cases - Shared authoring reference: Delegates to a canonical SKILL.md that defines the vocabulary and principles of good skill writing. - Cross-host translation guidance: Instructs the agent to translate host-specific invocation syntax and tool names to Codex equivalents without changing the workflow, constraints, or outputs. - Use Case: When drafting a new skill for your repository, invoke this Skill so the agent follows the authoritative writing guidelines and produces a SKILL.md with proper frontmatter, clear instructions, and predictable behavior. ## Quick Start Ask the agent to use the writing-great-skills reference to review or draft a SKILL.md for your new skill.

Frequently Asked Questions about writing-great-skills

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

FAQPage Schema
How do I write a good SKILL.md file?▼

A good SKILL.md starts with YAML frontmatter containing a name and description, followed by clear operational instructions. This Skill loads a canonical reference that defines the vocabulary and principles to follow for predictable skill behavior.

What makes an AI skill predictable?▼

Predictability comes from consistent vocabulary, explicit constraints, defined stop conditions, and unambiguous instructions in the SKILL.md body. This Skill's referenced guide codifies those principles for authors.

Can I use this skill with hosts other than Codex?▼

The wrapper instructs the agent to translate host-specific invocation syntax and tool names into Codex equivalents. The underlying workflow, constraints, and outputs remain unchanged regardless of the host.

Why does this SKILL.md only point to another file?▼

It is a generated synchronization stub created by tools/sync_agent_skills.py. It redirects the agent to the canonical skill under .claude/skills so multiple agent hosts share one authoritative source.

What are the limitations of this skill wrapper?▼

It contains no scripts, references, or assets of its own and depends entirely on the referenced canonical SKILL.md existing at the expected relative path. If that file is missing, the Skill has no operational content.

Related Skills

Explore More Software Engineering Skills→
GregoryHoGregoryHo
6

arc-using

none

Community
Basic
agent-ecosystemagent-ecosystem
2

nested-skill

Tests discovery of a nested SKILL.md via a parent references directory.

Official
Basic
thinking-machines-labthinking-machines-lab
4.0k

manage-skills

Audit and standardize Claude Code skills for frontmatter and repository conventions.

Official
Advanced
gitarborgitarbor

skills-creator

Create and validate Agent Skills following the agentskills.io specification.

Official
Basic