mcpField
A
add-skill

add-skill

github.com/openhandsAgent workflows17668 installsUpdated 1d ago
Repository

About add-skill

add-skill imports a skill from a GitHub repository into the current workspace. It is for users who want to install a repository skill locally, with URL parsing and a bundled fetch script handling retrieval.

Key features

  1. 01Parse supported GitHub skill URLs
  2. 02Fetch skills with a bundled script
  3. 03Verify the installed SKILL.md
  4. 04Install skills in the workspace
  5. 05Warn before replacing same-name skills

Use cases

  1. 01Add a skill from a GitHub URL
  2. 02Install a skill from a repository shorthand
  3. 03Check that an imported skill is available

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/openhands/extensions --skill add-skill

After installing, type/add-skillin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

README.md
.plugin/
plugin.json
scripts/
fetch_skill.py

Details

From the project README

Add Skill

Import skills from GitHub repositories into the current workspace.

Workflow

When a user requests to add a skill from a GitHub URL:

  1. Parse the URL to extract repository owner, name, and skill path
  2. Fetch the skill using the bundled script. Run it from this skill's directory (the directory containing this SKILL.md file): 
    python3 scripts/fetch_skill.py "<github-url>" "<workspace-path>"
  3. Verify that SKILL.md exists in the destination
  4. Inform the user the skill is now available

URL Formats Supported

  • https://github.com/owner/repo/tree/main/path/to/skill
  • https://github.com/owner/repo/skill-name
  • github.com/owner/repo/skill-name
  • owner/repo/skill-name (shorthand)

Example

User: /add-skill https://github.com/OpenHands/extensions/tree/main/skills/codereview

# Run the fetch script
python3 scripts/fetch_skill.py "https://github.com/OpenHands/extensions/tree/main/skills/codereview" "/path/to/workspace"

# Verify installation
ls /path/to/workspace/.agents/skills/codereview/SKILL.md

On Windows, use python if python3 is not available and verify with PowerShell, for example: Test-Path C:\path\to\workspace\.agents\skills\codereview\SKILL.md.

Response: "✅ Added codereview to your workspace. The skill is now available."

Notes

  • Installs workspace-locally into <workspace>/.agents/skills/<skill-name>/, not globally; that workspace is where the skill becomes available
  • Creates .agents/skills/ directory if it doesn't exist
  • Uses GITHUB_TOKEN for authentication (required for private repos)
  • Warns before overwriting existing skills with the same name

Comments

Markdown supported