Skip to content

Claude Code Skills Guide: Workflows, Examples, and Setup

Claude Code skills are reusable workflow instructions. A good skill does not just tell the agent what output to produce. It tells the agent how to think through the work, when to ask questions, what evidence to gather, and when to stop.

This page is a practical hub for the Claude Code skill patterns I keep coming back to. It is organized by the outcome you want: design a logo, interview a user before coding, run a Socratic UI review, research keywords, or set up a repo so skills have guardrails.

Start Here

Skill Types

Skill typeUse it whenExample
Interview skillThe user has a rough idea but not a complete specFeature planning, bug diagnosis, product decisions
Generation skillThe agent needs to produce multiple candidate artifactsLogos, storyboards, UI concepts
Review skillThe agent needs to compare work against standardsiOS HIG checks, accessibility review, code review
Research skillThe agent needs external data before actingKeyword research, Search Console analysis
Guardrail skillThe agent needs a repeatable safety processTDD, systematic debugging, release checks

The same skill can combine several of these. The logo skill, for example, is both an interview skill and a generation skill: it asks structured questions before it generates SVG concepts.

What Belongs in a Good Skill

A useful skill usually includes:

  • Trigger criteria — when the skill should run
  • Context gathering rules — which files, docs, or tools to inspect first
  • Decision points — where to use AskUserQuestion instead of guessing
  • Output criteria — what a finished artifact must include
  • Stop conditions — when to pause, ask, or refuse to continue

The stop conditions are underrated. Agents are good at continuing. Skills are where you encode when continuing would be the wrong move.

Repo and Agent Setup

Skills work best when the repo around them has guardrails. Start with How to Set Up Your Repo for Claude Code and Codex if you are adding agents to an existing project.

That setup post covers the boring pieces that make skills safer:

  • CLAUDE.md / AGENTS.md
  • CLI tools
  • linting and formatting
  • CI
  • hooks
  • plugins
  • MCP servers

SEO and Research Workflows

Claude Code is also useful for search and content workflows when it has access to real data.

Choosing a Claude Code Skill

Use the outcome to pick the right post:

OutcomeStart here
Create a product logoClaude Code logo design skill
Clarify a vague feature or bug requestClaude Code interview skills
Ask structured questions inside a skillAskUserQuestion Claude Code skill
Review an iOS UI against platform conventionsClaude Code Socratic iOS HIG skill
Research search demand before writingClaude Code keyword research workflow
Prepare a repo for agents and skillsClaude Code and Codex repo setup guide

The Pattern

The skills that work best tend to share the same shape:

  1. Gather real context.
  2. Ask targeted questions when user intent matters.
  3. Generate several options.
  4. Compare the options against explicit criteria.
  5. Refine the strongest direction.
  6. Produce a concrete artifact.

That pattern shows up in feature planning, debugging, logo design, testing workflows, and SEO research. The domain changes. The process discipline is the useful part.