Hands‑On Guide to Mastering Claude Agentic Skills + Full Resource List

Build your first Claude Skill

Skill is a Markdown‑formatted instruction set that Claude uses when the user's request matches the description.

Step‑by‑step creation

List existing Skills What Skills are available? Create a folder for the Skill mkdir -p ~/.claude/skills/explaining-code Write SKILL.md File must contain YAML front‑matter with name and description , followed by Markdown commands.

---
name: explaining-code
description: Use visual charts and analogies to explain code. Trigger when asked “How does this work?”
---

1. **Start with an analogy**: compare the code to a familiar everyday object.
2. **Draw a diagram**: use ASCII art to show flow or structure.
3. **Explain step by step**.
4. **Highlight a common pitfall**.

Load and verify Claude automatically reloads the Skill after creation or modification. Query the Skill list again; explaining-code should appear.

Test the Skill Open any code file and ask Claude, e.g., “这段代码是怎么工作的？” Claude should invoke explaining-code and return an explanation with analogies and ASCII diagrams. If not triggered, include keywords from the description.

Installing Skills on Antigravity

For Google Antigravity the layout is identical.

.agent/skills/
└─── my-skill/
    └─── SKILL.md

SKILL.md must start with the YAML header and then detailed Markdown instructions. Optional resources (scripts, examples, templates) can be placed alongside the file.

.agent/skills/my-skill/
├─── SKILL.md        # required
├─── scripts/        # optional
├─── examples/       # optional
└─── resources/      # optional

Curated Skill repositories

Anthropic official Skills (includes skill-creator) – https://github.com/anthropics/skills

UI UX Pro Max – front‑end/UI design – https://github.com/nextlevelbuilder/ui-ux-pro-max-skill

SEO Review – AI‑generated website SEO audit – https://github.com/leonardomso/33-js-concepts/tree/master/.opencode/skill/seo-review

Content Creator – blog article generation – https://github.com/davila7/claude-code-templates/tree/main/cli-tool/components/skills/business-marketing/content-creator

Skill Prompt Generator – high‑quality prompt generation for image tasks – https://github.com/huangserva/skill-prompt-generator

Superpowers – collection of 1.6 k‑star Skills covering brainstorming to testing – https://github.com/obra/superpowers

Planning‑with‑files – multi‑step task decomposition – https://github.com/OthmanAdi/planning-with-files

X‑article‑publisher‑skill – auto‑publish to X (Twitter) – https://github.com/wshuyi/x-article-publisher-skill

NotebookLM Skill – auto‑upload PDFs, YouTube links to NotebookLM – https://github.com/PleasePrompto/notebooklm-skill