# skill-creation-guide

> Claude/Codex skill by [@gleanwork](https://omgskills.com/library/gleanwork/index.md) · 25 stars · Updated 2026-10-28

Guide the user through authoring a new agent skill — when a skill is worth creating, the SKILL.md format, progressive disclosure, and common pitfalls. Also covers discovering skill opportunities from the user's work patterns and generating a SKILL.md from a description. Trigger phrases include "create a skill", "write a skill", "make a skill", "new skill", "SKILL.md format", "how do skills work", "skill best practices", "convert this workflow into a skill", "what should I automate", and "find skill opportunities". Don't use it for invoking existing skills — only when authoring a new one or understanding the skill format.

## Install

```sh
git clone https://github.com/gleanwork/claude-plugins /tmp/claude-plugins && ln -s /tmp/claude-plugins/plugins/glean/skills/skill-creation-guide ~/.claude/skills/skill-creation-guide
```

## From README

Skill Creation Guide Help the user author effective agent skills — single SKILL.md files (in the open Agent Skills format) that auto-trigger by context and provide specialized guidance. The format is shared across hosts (Claude Code, Cursor, and others); only the location differs. This skill covers three things: deciding whether a skill is worth creating, discovering candidates from the user's work, and generating a well-formed skill. BE SKEPTICAL Not every idea makes a good skill. Evaluate before creating: Recurrence — Will this be used repeatedly? ✅ Weekly or more → create ⚠️ Monthly → reconsider, may not be worth it ❌ One-time → skip Automation — Can it actually be automated? ✅ Clear, repeatable process → create ⚠️ Needs significant judgment each time → reconsider ❌ Too context-dependent, each case unique → skip Value — Is the cumulative time saved significant? ✅ Meaningful savings per use → create ❌ Slower to invoke than doing manually → skip Duplication — Does it already exist?

## Links

- HTML page: https://omgskills.com/library/gleanwork/claude-plugins/skill-creation-guide/
- GitHub: https://github.com/gleanwork/claude-plugins
- Author: [@gleanwork](https://omgskills.com/library/gleanwork/index.md)

## More from this repo

- [catch-up](https://omgskills.com/library/gleanwork/claude-plugins/plugins/glean/skills/catch-up/index.md) — Catch up on what you missed while away — meetings, decisions, action items, mentions, and important threads from a...
   - [@gleanwork](https://omgskills.com/library/gleanwork/index.md) · 25 stars
- [code-owners](https://omgskills.com/library/gleanwork/claude-plugins/plugins/glean/skills/code-owners/index.md) — Identify who owns, maintains, or has expertise in a specific code area — use when asked who to talk to about a system,...
   - [@gleanwork](https://omgskills.com/library/gleanwork/index.md) · 25 stars
- [codebase-context](https://omgskills.com/library/gleanwork/claude-plugins/codebase-context/index.md) — Gather architectural context about an internal system from code and documentation across the organization — use when...
   - [@gleanwork](https://omgskills.com/library/gleanwork/index.md) · 25 stars