Skip to content

feat: restructure .claude skills and add plugin marketplace support#162

Merged
spillai merged 5 commits intomainfrom
devin/1773870569-claude-skills-restructure
Mar 18, 2026
Merged

feat: restructure .claude skills and add plugin marketplace support#162
spillai merged 5 commits intomainfrom
devin/1773870569-claude-skills-restructure

Conversation

@devin-ai-integration
Copy link
Copy Markdown
Contributor

@devin-ai-integration devin-ai-integration bot commented Mar 18, 2026

Summary

Restructures the .claude directory to follow the standardized Agent Skill format (matching the pattern in vlm-run/skills):

  • Moved .claude/SKILL.md.claude/skills/vlmrun-cli-skill/SKILL.md (content unchanged)
  • Added .claude-plugin/marketplace.json — marketplace manifest listing the skill for remote installation
  • Added .claude-plugin/plugin.json — plugin metadata (author, homepage, license, keywords)
  • Added Claude Code installation instructions to README.md (new "### Claude Code" section)

This enables users to install the skill remotely via Claude Code:

/plugin marketplace add vlm-run/vlmrun-python-sdk
/plugin install vlmrun-cli-skill@vlm-run/vlmrun-python-sdk

Updates since last revision

  • README step 3 now uses vlmrun config init / vlmrun config set / vlmrun config show instead of .env file setup, per reviewer feedback.
  • Fixed source path in marketplace.json to ../.claude/skills/vlmrun-cli-skill (relative to .claude-plugin/) so it correctly resolves to the skill directory.
  • Sorted JSON keys alphabetically to satisfy pretty-format-json pre-commit hook.
  • Includes a minor black auto-format change in vlmrun/cli/_cli/chat.py (line-break in a typer.Option call, no behavioral change).

Review & Testing Checklist for Human

  • Test remote installation end-to-end: Run /plugin marketplace add vlm-run/vlmrun-python-sdk and /plugin install vlmrun-cli-skill@vlm-run/vlmrun-python-sdk in Claude Code to verify the skill is discovered and installed correctly. This is the only reliable way to validate the plugin spec paths.
  • Verify source path resolves correctly: The source field in marketplace.json is ../.claude/skills/vlmrun-cli-skill (relative to .claude-plugin/). Confirm this is the expected resolution behavior per the Claude Code plugin spec — it may need to be a repo-root-relative path instead.
  • Verify vlmrun config CLI commands: The README references vlmrun config init, vlmrun config set, and vlmrun config show. Confirm these are the correct subcommands and syntax.
  • Confirm naming convention: Both JSON files use "name": "vlmrun-cli-skill" — verify this matches expectations (the reference vlm-run/skills repo uses the bundle name "vlmrun-skills" rather than the individual skill name).

Notes

  • The SKILL.md content is unchanged — this is purely a structural reorganization.
  • JSON files are modeled after the .claude-plugin/ directory in vlm-run/skills.
  • The chat.py formatting change is an unrelated pre-commit hook auto-fix (no logic change).

Link to Devin session: https://app.devin.ai/sessions/43313e807036481d8b77bea2228393f2
Requested by: @spillai

- Move SKILL.md to .claude/skills/vlmrun-cli-skill/SKILL.md
- Add .claude-plugin/marketplace.json for remote skill installation
- Add .claude-plugin/plugin.json with plugin metadata

Co-Authored-By: Sudeep Pillai <sudeep.pillai@gmail.com>
@devin-ai-integration
Copy link
Copy Markdown
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

Co-Authored-By: Sudeep Pillai <sudeep.pillai@gmail.com>
… README

Co-Authored-By: Sudeep Pillai <sudeep.pillai@gmail.com>
Copy link
Copy Markdown
Contributor

@spillai spillai left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Recommend using vlmrun config instead of .env files.

README.md Outdated
/plugin install vlmrun-cli-skill@vlm-run/vlmrun-python-sdk
```

3. Set up your environment variables by creating an `.env` file with your API key from [app.vlm.run](https://app.vlm.run):
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Instead of setup via .env file, recommend the vlmrun config init and vlmrun config show/set

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated to use vlmrun config init / vlmrun config set / vlmrun config show instead of .env files.

Co-Authored-By: Sudeep Pillai <sudeep.pillai@gmail.com>
@spillai spillai merged commit 135bd41 into main Mar 18, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant