AI-Custom-Skills

A collection of custom Agent Skills for building reusable AI capabilities.

Skill Validation

AI-Custom-Skills

This repository contains custom Agent Skills aligned with the https://agentskills.io specification. It provides guidelines, examples, and a standard structure for building reusable skills.

What is inside

  • PRD.md: Product requirements and repository constraints.
  • CONTRIBUTION.md: Contribution workflow and skill standards.
  • AGENTS.md: Guidance for agentic coding tools in this repo.
  • skills/: Home for non-sample skills.
  • sample-skill/: Minimal example skill.
  • sample-skill-advanced/: Progressive disclosure example with references/, assets/, and scripts/.

How to use

  1. Review the spec and best practices:
  2. Use the sample skills as templates for new skills.
  3. Validate skills with skills-ref.

OpenCode local skills

OpenCode discovers skills from .opencode/skills/<name>/SKILL.md. This repo keeps source skills in skills/, so create symlinks into .opencode/skills/ for local use:

mkdir -p .opencode/skills
ln -s ../../skills/git-commit-helper .opencode/skills/git-commit-helper
ln -s ../../skills/git-pr-helper .opencode/skills/git-pr-helper

Creating a new skill

  1. Copy the structure from sample-skill/ or sample-skill-advanced/.
  2. Create the skill folder under skills/.
  3. Name the folder with lowercase letters, numbers, and hyphens.
  4. Ensure SKILL.md frontmatter matches the folder name and includes a clear description.
  5. Keep SKILL.md under 500 lines and under 5,000 tokens.
  6. Validate the skill with skills-ref validate.

Validate a skill

This repo includes the Agent Skills reference validator as a git submodule in third_party/agentskills.

git submodule update --init --recursive
cd third_party/agentskills/skills-ref
uv sync
source .venv/bin/activate
skills-ref validate /path/to/skill

Licensed under the Apache License 2.0. See LICENSE.