writing-skills

name

writing-skills

description

Create, edit, and verify golem-powers skills following the standard SKILL.md structure. Provides templates for skill frontmatter, workflow files, adapter files, and eval fixtures. Includes validation checks for description length, trigger word coverage, and structural completeness. Use when creating a new skill from scratch, editing an existing skill's structure or content, adding workflows or adapters to a skill, or verifying a skill meets quality standards before deployment. Triggers on 'create skill', 'write skill', 'new skill', 'skill template', 'edit skill', 'skill structure'. NOT for: invoking existing skills (call them directly), superpowers skills (different structure and location), or skill-creator agent workflows. Use when this capability is needed.

Writing Golem-Powers Skills

Meta-skill for creating executable skills. Skills are tools that Claude can invoke and automatically execute.

Skill Structure

Every golem-powers skill MUST have this structure:

skills/golem-powers/<skill-name>/
├── SKILL.md              # REQUIRED: Frontmatter + documentation
├── CLAUDE.md             # OPTIONAL: Environment requirements, complex setup
├── scripts/              # REQUIRED: Executable files
│   ├── default.sh        # Pattern A: Bash script
│   └── run.sh            # Pattern B: Wrapper for TypeScript
├── src/                  # OPTIONAL: TypeScript source (Pattern B)
│   └── index.ts
├── package.json          # OPTIONAL: Required if using TypeScript
├── bun.lock              # OPTIONAL: Required if using TypeScript
└── workflows/            # OPTIONAL: Multi-step procedures
    ├── create.md
    └── verify.md

SKILL.md Frontmatter (REQUIRED)

---
name: <skill-name>
description: <when to use this