Back to marketplace

Writing Skills (Meta-Skill)

Creates, edits, and verifies agent skills before deployment — best practices, examples, graph conventions, and subagent-based testing.

Developer Toolsdeveloper-toolsstandard
by AgentVoltv1.0.0Published 1y ago
Free to sign up · every skill included with AgentVolt Pro

Before & after

Same prompt, same agent — the only difference is the skill.

Prompt“I need to create a new skill for managing PostgreSQL migrations. Help me write and verify it.”
Beforegeneric AI agent
To create a skill, you'll want to write a SKILL.md file that documents the skill's purpose, examples, and instructions. You should include sections on what it does, when to use it, and sample outputs. Make sure your instructions are clear and follow your team's conventions. You could then test it manually to ensure it works as intended. Once you're satisfied, you can deploy it into your Claude Code environment.
Afterwith Writing Skills (Meta-Skill)
SKILL CREATION + VERIFICATION WORKFLOW

STEP 1: Interview (gathering)
-> Skill purpose: automate PostgreSQL migration generation and safety checks
-> Trigger phrases: migrate, schema change, migration status, db-breaking
-> Team conventions: migrations named YYYYMMDD_description, rollback scripts required
-> Testing depth: unit test migrations + integration test on staging schema

STEP 2: Write SKILL.md
[File generated with sections: What You Get, When to Use, Example Output, Guardrails, Decision Tree]

STEP 3: Subagent Verification
-> Verification agent tests skill against 12 scenarios
   • Test 1: missing rollback script (should fail with guidance)
   • Test 2: breaking schema change without backfill (should block)
   • Test 3: valid migration with tests (should pass)
   • ...9 more edge cases
-> Reports: PASS (11/12) or FAIL with details

STEP 4: Output
File: skills/postgres-migration-manager/SKILL.md
Verification: PASS (11/12 tests)
Ready to Deploy: yes

Next: commit to skills/ and register in .claude/settings.json

About this skill

name: writing-skills description: Use when Creates, edits, and verifies agent skills before deployment — best practices, examples, graph conventions, and subagent-based testing.

Writing Skills (Meta-Skill)

A meta-skill for authoring other skills correctly: enforces conventions and runs subagent-based tests before a new skill is considered done.

What you get

  • A new or edited SKILL.md file that has passed verification testing.

Customize your output

  • Skill purpose
  • testing depth required.

Example output

A verified, ready-to-deploy skill file.

Best for

Teams building and maintaining their own skill libraries.

SKILL.md preview

SKILL.md
---
name: writing-skills
description: Use when authoring, editing, or verifying a new agent skill before it is deployed, to keep it consistent with conventions and actually tested.
version: 1.0.0
category: Developer Tools
author: AgentVolt
license: proprietary
tags:
  - developer-tools
  - standard
---

# Writing Skills (Meta-Skill)

Enforces conventions and runs subagent-based tests before a new skill is considered done.

## When to use

… (sign up to view the full skill)
Sign up to view, copy, and install the full skill