Agent skill authoring

Skill swd3k/skills/agent-skills/workflows/agent-skill-authoring

Author portable agent skills (SKILL.md) compatible with Codex, Claude, Cursor, and Grok. Use when creating or refining skills in this repo.From its SKILL.md

Install

npx -y skills add swd3k/skills --skill agent-skill-authoring

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

0.9 KB, 200 tokens by cl100k_base, as published. Nobody here has run it

Agent Skill Authoring

Contract

agent-skills/<category>/<skill-name>/
  SKILL.md       # required
  REFERENCES.md  # links only, optional
  ARTICLE.md     # long form, optional
  demo/          # optional proof

SKILL.md frontmatter

---
name: skill-folder-name
description: What it does + when to use (triggers). One tight paragraph.
---

Body sections that work

When to use
Defaults
Step workflow
Snippets
Pitfalls
Acceptance checks
Questions to ask if vague

Style

Procedural, skimmable, confident
Defaults over essays
No secrets, no private paths
Portable across repos

Validation

Clear trigger in description
Concrete steps
At least one acceptance check
Name matches folder

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.