SkillsCokac
Sign in
User Guide

Claude Code Skills
Getting Started with Claude Code Skills

Supercharge your Claude Code with Skills and Collections from SkillsCokac.

What are Skills?

Just like installing apps on your smartphone, you can add new capabilities to Claude.
Skills are apps in document form, and SkillsCokac is the skill store that brings them all together.

Easy Examples

📱 Like smartphone apps:

  • •Install "Document Summary" Skill → Claude summarizes long documents neatly
  • •Install "Code Review" Skill → Claude systematically reviews your code
  • •Install "Excel Report" Skill → Claude automatically converts data into reports

💡 Skills are written as text documents (markdown), a kind of natural language program that AI can understand and execute.

Advantages
  • Guaranteed Consistency

    Always delivers the same quality of output for the same task

  • Reusability

    Create once and automatically use in all conversations

  • Extended Capabilities

    Grant new abilities like code execution, file access, and API calls

Structure of a Skill
Skills are organized as folders, with the core being the SKILL.md file.
my-awesome-skill/
SKILL.md
Required
reference.md
Optional
examples.md
Optional
scripts/
templates/

Creating Skills

Extend Claude's capabilities by creating your own Skills

Personal Skills

Personal Skills available in all projects. Save to ~/.claude/skills/.

~/.claude/skills/

Personal workflows and preferences, Experimental Skills under development, Personal productivity tools

Project Skills

Project Skills shared with the team. Save to .claude/skills/.

.claude/skills/

Team workflows and conventions, Project-specific expertise, Shared utilities and scripts

Plugin Skills

Skills provided through Claude Code plugins. Can be downloaded and used from SkillsCokac.

Writing SKILL.md

A guide to creating effective Skills

Required Fields
Create a SKILL.md file with YAML frontmatter and Markdown content.

• name: Use only lowercase letters, numbers, and hyphens (max 64 characters)

• description: Describe what the Skill does and when to use it (max 1024 characters)

💡 The description field is crucial for Claude to discover the Skill. Include both what the Skill does and when Claude should use it.

SKILL.md Example
---
name: your-skill-name
description: Brief description of what this Skill does
---
# Your Skill Name
## Instructions
Clear, step-by-step guidance...

Advanced Features

Adding Supporting Files
In addition to SKILL.md, you can create additional files to extend the Skill's functionality.
my-skill/
├── SKILL.md
├── reference.md
├── scripts/
└── templates/

Claude reads these files only when needed, using progressive disclosure to manage context efficiently.

Restricting Tool Access with allowed-tools
Use the allowed-tools frontmatter field to restrict which tools Claude can use when the Skill is active.
---
allowed-tools: Read, Grep, Glob
---

Read-only Skills that should not modify files, Skills with limited scope, Security-sensitive workflows

💡 If allowed-tools is not specified, Claude follows the standard permission model.

Testing & Debugging

Testing Skills

After creating a Skill, test it by asking questions that match the description.

Example:

If the description mentions "PDF files", ask "Can you help me extract text from this PDF?"

💡 Claude will autonomously use the Skill if it matches the request. No need to explicitly invoke it.

Debugging Skills
If Claude is not using the Skill, check the following

Make `description` specific

❌ Too vague: "Helps with documents"

✅ Specific: "Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files."

Check file paths

Verify that the SKILL.md file is in the correct location.

Validate YAML syntax

Invalid YAML prevents the Skill from loading. Check start/end ---, indentation, etc.

View errors

Run Claude Code in debug mode to see Skill loading errors: claude --debug

Practical Examples

Simple Skill (Single File)
A simple Skill example that generates git commit messages
---
name: commit-helper
description: Generate commit messages
---
Skill with Tool Permissions
Read-only code review Skill that uses only Read, Grep, Glob tools
---
name: code-reviewer
allowed-tools: Read, Grep, Glob
---
Multi-File Skill
PDF processing Skill example with multiple files and scripts
pdf-processing/
├── SKILL.md
├── FORMS.md
└── scripts/

What are Collections?

A bookmark system for organizing your favorite Skills and Snippets by topic.

Personal Library

Gather frequently used Skills in one place for quick access.

Topic Classification

Organize Skills by topics like "Dev Tools", "Documentation", "Data Analysis", etc.

Public Sharing

All Collections are public, allowing you to freely share useful Skill sets with others.

Using with Claude Code

Easily install and use hundreds of Skills from SkillsCokac with npx skillscokac command.

1
Install Individual Skills Directly
How to install directly from a specific Skill page

Each Skill's detail page displays an "Install Skill" card. Run the command in your terminal:

npx skillscokac -i skill-name

Usage

After installation, run /skill-name in Claude Code

2
Install Multiple Skills at Once with Collections
Install curated Skill sets all at once

Browse public Collections on the Collections. Each Collection page shows installation commands:

npx skillscokac -c collection-id

With this single command, you can install all Skills included in the Collection.

💡 Tip: Use Collections organized by topics like "Dev Tools", "Documentation", "Data Analysis" for convenience.

Need more information?