skills-transfer

name	skills-transfer
description	Guides intake of Agent Skills from Git repos, skills.sh, and pkuppens/pkuppens into IDE paths or this library. Covers project vs global install, derivative skills, and catalog maintenance. Use when installing, adapting, or contributing skills.

Skills transfer

Move skills between sources (public registry, Git repos, this library) and agent environments without duplicating the Agent Skills specification.

When to use

• Install skills from skills.sh, npx skills add, or symlink
• Bring skills from pkuppens/pkuppens or other repos into a project
• Create a derivative skill that references a canonical or public base skill
• Maintain the library catalog (SKILL_TREE.md, bundles, optional skills.sh listing)
• Migrate a whole tree into pkuppens/skills → activate nested skill repo-transfer

Quick path

1. Discover — npx skills find <keywords> or browse skills.sh; check sources.
2. Choose install scope — project vs global: install-modes.
3. Reuse or build — prefer install when a public skill fits; author only the delta (see derivative-skills).
4. Validate — skills-ref validate <skill-dir> (same check as CI).
5. Contribute here — follow repo-transfer for PRs into this library.

Derivative skills (summary)

Do not edit canonical skills in place when you only need a personal or team variant. Add a new folder with its own name and description, and link to the base skill in the body. See examples.md and derivative-skills.

Catalog (summary)

Keep skills/SKILL_TREE.md aligned with folders under skills/. Optional curated sets live under docs/bundles/ (planned). Optional promotion on skills.sh is marketing, not required for merge. Details: catalog.

Additional resources

• install-modes.md — symlink, Skills CLI, project vs global
• sources.md — pkuppens/pkuppens, skills.sh, arbitrary Git
• derivative-skills.md — wrap/reference pattern, upstreaming
• catalog.md — SKILL_TREE, bundles, skills.sh
• examples.md — derivative skill sketch
• repo-transfer/SKILL.md — land a repo skills tree here