Skip to content

Getting Started

Josemalyson Oliveira edited this page Jun 27, 2026 · 1 revision

Getting Started

This guide will help you install and use Custom Skills with your AI coding assistant.


Prerequisites

  • An AI coding assistant (Claude Code, GitHub Copilot, etc.)
  • Git installed on your system
  • Basic familiarity with the command line

Installation

Option 1: Clone the Full Repository

git clone https://github.com/josemalyson/custom-skills.git
cd custom-skills

Option 2: Install Individual Skills

Copy only the skills you need to your agent's skill directory:

# For Claude Code
cp -r custom-skills/learning-trail ~/.claude/skills/

# Install multiple skills
cp -r custom-skills/learning-trail ~/.claude/skills/
cp -r custom-skills/html-first ~/.claude/skills/

Option 3: Symlink (Recommended for Development)

ln -s /path/to/custom-skills/learning-trail ~/.claude/skills/learning-trail

Verify Installation

After installing, test that the skill activates:

"Quero aprender Kubernetes do zero"

If the skill activates, you'll see the agent follow the learning-trail workflow.


Skill Activation

Skills activate automatically based on trigger phrases in the skill's description field. You don't need to manually invoke them.

Example Triggers

Phrase Activates Skill
"Me ajuda a entender o projeto X" agent-code-detective
"Compare React, Vue, and Svelte" html-first
"Quero aprender Kubernetes" learning-trail
"Audit my cluster" k8s-investigation
"Set up pre-commit hooks" pre-commit-quality-gate

Configuration

Skills are configured through their SKILL.md files. Each skill may have:

  • YAML frontmatter — Name, description, trigger phrases
  • References — Supporting documents in references/ folder
  • Templates — Ready-to-use starting points
  • Scripts — Executable tools for automation

To customize a skill, edit its SKILL.md file directly.


Directory Structure

~/.claude/skills/
├── agent-code-detective/
│   ├── SKILL.md
│   └── references/
├── html-first/
│   ├── SKILL.md
│   ├── references/
│   └── templates/
├── k8s-investigation/
│   ├── SKILL.md
│   └── ...
├── learning-trail/
│   ├── SKILL.md
│   └── ...
└── pre-commit-quality-gate/
    ├── SKILL.md
    └── ...

Next Steps


Last updated: June 2026

Clone this wiki locally