🛠️ skillctrl · Manage and deploy AI skills

Helps you import, update, and deploy AI agent skills.

---

🚀 Highlights

• Multiple IDE Support: Deploy skills to IntelliJ (Codeium), Windsurf, Antigravity, Claude Code, Cursor, and Codex.
• TUI-Driven Interface: Interactive terminal wizard for seamless management.
• GitHub Import & Update: Import skills from GitHub URLs or owner/repo, then check/update later from GitHub upstream using local import metadata.
• User Config: Register your custom skills repository by setting ownSkillsDir in ~/.skillctrl/config.json.

---

⚙️ Install (Users)

Required Node.js version: 22+.

1. Install from npm (recommended)

npm i -g skillctrl
skillctrl

2. Run without global install

npx skillctrl@latest

---

🎨 How to Add Your Own Skills

To expand your local toolkit:

1. In your own skills repository/folder, pick a category (or create one).
2. Create a folder (e.g., .../skills/development/my-new-skill/).
3. Add a SKILL.md with standard YAML frontmatter (name and description).
4. Set that folder in skillctrl via Own Skills Dir (saved in ~/.skillctrl/config.json).
5. Run skillctrl to verify and deploy.

---

👩‍💻 Development Setup

The CLI manages and deploys skills to your local environment.

1. Install dependencies, build, and link locally

npm install
npm run build
# If you previously used a local linked dev build:
npm unlink -g skillctrl
npm link

---

🎮 Usage

🖥️ Interactive Menu (TUI)

The easiest way to manage your skills is via the guided wizard:

# Global command (if linked)
skillctrl

# Or local development run
npm start

❓ Command Help

skillctrl --help

🔁 If you moved your local skills folder

If your own skills were moved to another path/repository, update ownSkillsDir:

skillctrl
# then go to: Own Skills Dir

---

📥 Import & Update from GitHub

From the interactive menu:

• Import skill from GitHub: accepts full GitHub URLs (https://github.com/owner/repo), short format (github.com/owner/repo), or owner/repo shorthand (owner/repo).
• Check & update imported skills: checks imported skills listed in ~/.skillctrl/skill-imports.json against their GitHub source.
• Delete skill(s) opens the deletion submenu:
  • Delete imported skill(s): remove one, many, or all imported skills. This deletes both:
    • imported local files under ~/.skillctrl/imported/,
    • matching entries in ~/.skillctrl/skill-imports.json.
  • Delete globally installed skill(s): remove one, many, or all known skills from selected IDE global paths.

Imported skills are stored outside this repo:

• ~/.skillctrl/imported/{category}/{skill}/

Optional token for higher GitHub API limits:

export GITHUB_TOKEN="your_token"

---

🧩 IDE Compatibility Paths

See IDE_COMPATIBILITY.md.

---

🔗 References

• Format specification for Agent Skills: https://agentskills.io/specification.md
• Skill authoring best practices: https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices.md
• Validate skills tool: https://github.com/agentskills/agentskills/tree/main/skills-ref
• Skill creator: https://github.com/anthropics/skills/blob/main/skills/skill-creator/SKILL.md
• Agent skills tool: https://github.com/vercel-labs/skills