How to Use Claude Skills: Practical Setup Guide (2026)

Learn how to work with Claude Skills in a practical way: install supported skills, author a SKILL.md file, add scripts carefully, and separate Claude-native behavior from platform-specific workflow layers.

From Prompts to Skills

1

Standardize Workflows: Ensure every code review or commit message follows the exact same format.

2

Execute Code: Skills can contain Python/Bash scripts that run locally (e.g., to lint code or query a database).

3

Share Expertise: Package your best prompts and scripts into a skill folder with a SKILL.md file and share it with your team.

Level 1: Installing Available Skills

  • Option A: Using Claude Code (CLI). Open your terminal and use the currently supported plugin flow shown in Anthropic documentation or the repository README.
Plain Text
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills
  • Option B: Using a platform-specific visual manager. The steps below describe a possible Verdent-style workflow and should be treated as product-specific guidance rather than Anthropic documentation.
1

Open your platform interface.

2

Go to the area where installed tools or skills are managed.

3

Review the available packages, verify the source, and install the one you need.

4

On platforms that support multi-agent workflows, you may choose to separate skills by role, such as frontend review versus backend review.

Level 2: Authoring Your First Skill

1

Create the File Structure

Plain Text
my-skills/ └── strict-reviewer/ └── SKILL.md
2

Write the Frontmatter (YAML) This tells Claude when to use the skill.

Plain Text
---
name: strict-review
description: Reviews code for security vulnerabilities and performance issues. Use when the user asks for a PR review or to check code.
---

# Code Review Guidelines
3

Write the Instructions (Markdown) This tells Claude how to perform the task.

Plain Text
# Code Review Guidelines You are a strict code reviewer. For every file provided: 1. Check for **OWASP Top 10** vulnerabilities. 2. Identify O(n^2) or worse algorithmic complexity. 3. Ensure variable naming follows snake_case for Python. Output format: - 🔴 [Critical]: <Issue> - 🟡 [Warning]: <Issue>
4

Make the skill available by placing it in Claude’s skills directory, such as ~/.claude/skills/ for personal use or .claude/skills/ for project-specific use.

Level 3: Adding Executable Scripts

1

Add a Script Create run_lint.py in your skill folder.

Plain Text
# strict-reviewer/scripts/run_lint.pyimport sys # ... logic to run pylint and capture output ... print(lint_report)
2

Update SKILL.md Tell Claude to run this script.

Plain Text
... Before analyzing the code manually, run the linter script to get objective metrics: `python scripts/run_lint.py --target {target_file}` Use the output of this script to inform your review. ...
  • Now, when you invoke the skill, Claude will autonomously execute the Python script on your machine, read the output, and generate a review based on real data.

Claude Skills Cookbook

Recipe 1: The Commit Message Standardizer

  • Goal: Force all git commits to follow "Conventional Commits".
  • Frontmatter: name: commit-msg, description: Generates git commit messages.
  • Instruction: "Always format as <type>(<scope>): <subject>. Types allowed: feat, fix, docs..."

Recipe 2: The Data Analyst

  • Goal: Visualize CSV files.
  • Script: plot_data.py (Uses Matplotlib to generate a .png).
  • Instruction: "When given a CSV, run plot_data.py to generate a histogram, then describe the trends seen in the image."

Recipe 3: The Documentation Updater

  • Goal: Keep READMEs in sync.
  • Instruction: "Read src/ files. Compare with README.md. If functions are missing documentation, generate a diff to add them."

Level 4: Orchestration in a Platform Layer

The "Parallel Review" Workflow:

1

Select files: choose a batch of modified files in your workspace.

2

Select a skill: choose your custom strict-review skill.

3

Action: Click "Parallel Run".

4

Result: the platform may spin up isolated task runners or agents, each applying the same skill to a different file.

5

Merge the results back into one review summary.

Frequently Asked Questions

Where do I save my custom skills?
By default, Claude looks in ~/.claude/skills for personal skills and .claude/skills for project-specific skills. Platform-specific management layers may provide additional ways to organize those paths.
Can a skill call another skill?
Yes. This is called Skill Composition. You can create a "Master Architect" skill that explicitly instructs Claude to "First use the research skill, then use the coding skill."
How do I debug a skill that isn't working?
Start with the basics: confirm the skill folder is in the expected location, confirm that SKILL.md parses correctly, and confirm that any referenced script runs successfully in your environment. Some platforms may also provide additional logs.
Do I need Python installed?
Only if your skill uses Python scripts. Skills can use any runtime available in your environment (Node.js, Rust, Go, Bash). Claude simply executes the terminal command you provide.