A collection of Agent Skills for KTHAIS AI coding agents.

Skills are reusable capabilities that give agents procedural knowledge for specific tasks. Install them with the skills CLI.

npx skills add kthaisociety/skills

Install everything non-interactively:

npx skills add kthaisociety/skills --all

Or globally:

npx skills add kthaisociety/skills --all --global --yes

Install a single skill:

npx skills add kthaisociety/skills --skill <skill-name>

List skills in this repo:

npx skills add kthaisociety/skills --list

Browse the collection on skills.sh/kthaisociety/skills.

Skills are available to your agent after install. The agent loads them when the task matches a skill description.

This is a managed collection, not a dump of npx skills add agent installs.

Upstream repositories
        ↓
sources.json + npm run skill:sync
        ↓
kthaisociety/skills (this repo)
        ↓
npx skills add kthaisociety/skills --all

Do not populate this repo by running npx skills add against other repositories. That installs into agent directories (.agents/, .claude/, etc.), not into this Git tree.

See AGENTS.md for maintainer guidance.

Each skill is a directory with a SKILL.md (YAML frontmatter + instructions), matching the skills.sh / Agent Skills format:

skills/
├── internal/
│   └── <first-party-skill>/SKILL.md
└── external/
    └── <vendored-skill>/

The CLI discovers catalog-nested skills under skills/internal/ and skills/external/.

# Vendor a new external skill (discovers nested paths like skills/productivity/<name>)
npm run skill:add -- owner/repo skill-name
npm run skill:add -- https://github.com/owner/repo --skill skill-name

# Override source path when needed
npm run skill:add -- owner/repo local-name path/to/skill

# Remove a vendored external skill
npm run skill:remove -- skill-name
npm run skill:remove -- --skill skill-name

# Update vendored skills to latest upstream commits
npm run skill:sync

# Check for updates without writing (exit 1 if outdated)
npm run skill:check

# Install this collection locally (for testing discovery)
npm run skills:install

A weekly GitHub Action runs skill:sync and opens a PR when upstream skills change.

See LICENSE. Vendored skills keep their upstream licenses.