.agent/skills/skill-manager/SKILL.md
Unified skill management for AI IDEs. Use when users want to: list skills ("what skills do I have", "show installed skills"), search skills ("find skills for X", "search for PDF skill"), install skills ("install a skill", "add skill from GitHub"), create skills ("create a new skill", "make a skill"), sync skills ("sync to all IDEs", "push skills"), remove skills ("remove skill X", "uninstall skill"), validate skills ("validate my skills", "check skill format"), export/import profiles ("export my skills", "import profile", "sync across machines"). Supports 5 IDEs: Claude Code, Cursor, Codex, Gemini CLI, Antigravity. IMPORTANT: When creating or modifying skills, always follow the guidelines in references/skill-creator/SKILL.md.
npx skillsauth add Kang-chen/kownledgeBase skill-managerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Unified CLI for managing AI skills across all IDEs.
When creating, installing, or modifying skills, ALWAYS read and follow:
references/skill-creator/SKILL.md
This is the authoritative guide for skill structure, including:
~/.ai-skills/ - Single Source of Truth~/.ai-skills/skill-manager/references/skill-creator/SKILL.md~/.claude/skills/~/.cursor/skills/~/.codex/skills/~/.gemini/skills/~/.gemini/antigravity/skills/~/.ai-skills/skill-manager/config.json| Task | Command |
|------|---------|
| Interactive menu | skills |
| Search skills | skills search "query" |
| Install from URL | skills install <github-url> |
| Create new skill | skills create <name> |
| Sync to IDEs | skills sync |
| List installed | skills list |
| Remove skill | skills remove <name> |
| Validate skill | skills validate <name> |
| Export profile | skills export |
| Import profile | skills import <file> |
| Check status | skills status |
| Verify sync | skills verify |
User: "What skills do I have installed?"
python ~/.ai-skills/skill-manager/scripts/skills list --json
User: "Find me a skill for working with Docker"
python ~/.ai-skills/skill-manager/scripts/skills search "docker"
User: "Install the docx skill from anthropics"
python ~/.ai-skills/skill-manager/scripts/skills install https://github.com/anthropics/skills/tree/main/skills/docx
User: "Create a skill for formatting SQL"
python ~/.ai-skills/skill-manager/scripts/skills create sql-formatter
User: "Sync my skills to all IDEs"
python ~/.ai-skills/skill-manager/scripts/skills sync
User: "Export my skills to share with another machine"
python ~/.ai-skills/skill-manager/scripts/skills export --gist
When called without arguments, displays interactive menu:
╔════════════════════════════════════════════════════╗
║ Skill Manager - Interactive Mode ║
╠════════════════════════════════════════════════════╣
║ Installed Skills: 15 ║
║ Enabled IDEs: claude, cursor, codex, gemini ║
╚════════════════════════════════════════════════════╝
1. List installed skills
2. Search community skills
3. Install a skill
...
Search community skills database.
python ~/.ai-skills/skill-manager/scripts/skills search "python testing"
Install from GitHub URL or search results.
# From URL
python ~/.ai-skills/skill-manager/scripts/skills install https://github.com/anthropics/skills/tree/main/skills/docx
# From search
python ~/.ai-skills/skill-manager/scripts/skills install --query "pdf" --index 1
Create new skill from template (follows skill-creator guidelines).
python ~/.ai-skills/skill-manager/scripts/skills create my-skill --resources scripts,references
Sync skills to all enabled IDEs.
# Sync all
python ~/.ai-skills/skill-manager/scripts/skills sync
# Sync single skill
python ~/.ai-skills/skill-manager/scripts/skills sync my-skill
# Dry run
python ~/.ai-skills/skill-manager/scripts/skills sync --dry-run
Validate skills against guidelines and verify sync.
python ~/.ai-skills/skill-manager/scripts/skills validate my-skill
Export and import skill profiles for cross-machine sync.
# Export to Gist
python ~/.ai-skills/skill-manager/scripts/skills export --gist
# Import from Gist
python ~/.ai-skills/skill-manager/scripts/skills import --gist <gist-id>
-g, --global: Global scope (~/.ai-skills/)-l, --local: Project scope (.ai-skills/)| Error | Solution |
|-------|----------|
| git clone fails | Check URL, network, or if repo is private |
| No SKILL.md found | Skill repo may be structured differently |
| Invalid YAML | Show syntax error line and suggest fix |
| Permission denied | Check directory permissions |
| Skill already exists | Ask if user wants to update or reinstall |
| Sync hash mismatch | Run skills sync --force to overwrite |
Edit ~/.ai-skills/skill-manager/config.json to customize:
git.auto_commit: Enable/disable auto commit (default: true)git.auto_push: Enable/disable auto push (default: false)sync.auto_after_install: Auto sync after install (default: true)enabled_ides: List of IDEs to sync toexclude_skills: Skills to exclude from syncpreserve_target_skills: Directories to preserve in targets (e.g., Codex .system/)Always refer to: references/skill-creator/SKILL.md
tools
Project-based file organization and rule loading guidance. Defines project memory system, file structure by project, and mandatory rule loading workflow for archival tasks.
documentation
Rules for storing and isolating sensitive/private notes and credentials. Defines detection patterns, handling procedures, and organization guidelines.
development
Rules for categorizing notes into planning, programming, and biology directories. Includes keyword matching, file formatting, and special commands like TODO archival. Trigger on: 归档TODO, 周归档. Also handles [~] cancelled tasks.
development
Organizes notes into the personal knowledge base based on predefined rules. Use when the user wants to save, categorize, or organize notes and ideas, or when content is prefixed with `[[[`. Trigger on: 周回顾, weekly review (runs full weekly review workflow), or any inbox processing request. Proactive: On Fridays/weekends when last review was >5 days ago, suggest "本周还未进行周回顾".