agent-skills: Skill for Claude Code

Simple Skills Manager

Manage skill tips in ~/.claude/skills/ that point to skills from local paths or git repositories, enabling dynamic invocation via /{group}-{skill-name}.

Note: We use hyphen - as separator instead of colon : because Windows paths don't support colons in filenames.

Constants

• Repos directory: ~/.claude/simple-skills-manager-repos/
• Skills directory: ~/.claude/skills/
• Backup directory: ~/.claude/simple-skills-manager-backup-last-skills/

Workflow

Step 1: Ask Operation Type

First, ask the user what operation they want to perform:

{
  "questions": [{
    "question": "What operation would you like to perform?",
    "header": "Operation",
    "options": [
      {"label": "Add (Recommended)", "description": "Add skills from a local path or git repository"},
      {"label": "Update", "description": "Update an existing skill group (re-sync from source)"},
      {"label": "Remove", "description": "Remove an existing skill group"}
    ],
    "multiSelect": false
  }]
}

Step 2: Collect Information Based on Operation

For "Add" Operation

Ask user to directly input the source path or git URL:

{
  "questions": [{
    "question": "Please enter the local path or git URL for the skills:",
    "header": "Source",
    "options": [
      {"label": "Example: /path/to/skills", "description": "Local directory containing SKILL.md files"},
      {"label": "Example: https://github.com/user/repo.git", "description": "Git repository URL (will be cloned)"}
    ],
    "multiSelect": false
  }]
}

The user will select "Other" and type the actual path or URL. The system will auto-detect the source type:

• Git URL: starts with http://, https://, git@, or ends with .git
• Local path: everything else (treat as filesystem path)

After getting the source, ask for the group name:

{
  "questions": [{
    "question": "What group name should be used as prefix? (e.g., 'mygroup' creates '/mygroup-skill-name')",
    "header": "Group",
    "options": [
      {"label": "Use folder name", "description": "Use the source folder/repo name as group"},
      {"label": "Custom", "description": "Enter a custom group name"}
    ],
    "multiSelect": false
  }]
}