feat(skills): add Agent Skill for the mcpls CLI - #278
Merged
Conversation
github-actions
Bot
added
the
documentation
Add skills/mcpls/ with SKILL.md and references/configuration.md, a spec-compliant Agent Skill (agentskills.io) that teaches an AI coding agent to install, configure, and run the mcpls binary itself, as opposed to the MCP tools it exposes once running. Link it from README.md's Documentation section.
bug-ops
force-pushed
the
add-an-agent-skill-agentskills
branch
from
August 4, 2026 21:57
c6c6e30 to
5442975
Compare
There was a problem hiding this comment.
Pull request overview
Adds a spec-compliant Agent Skill under skills/mcpls/ so AI coding agents can install, configure, and run the mcpls CLI (distinct from the MCP tools mcpls exposes once running), and links it from the main docs surfaces.
Changes:
- Add
skills/mcpls/SKILL.mdwith installation, CLI/env var reference, client registration, config search order + trust model, and troubleshooting pointers. - Add
skills/mcpls/references/configuration.mdas a compactmcpls.tomlschema/routing reference. - Link the skill from
README.mdand add an entry toCHANGELOG.mdunder Unreleased.
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.
| File | Description |
|---|---|
| skills/mcpls/SKILL.md | New Agent Skill instructions for operating the mcpls binary (install/config/run, trust model, transports). |
| skills/mcpls/references/configuration.md | Reference tables for mcpls.toml fields and routing behavior to keep SKILL content concise. |
| README.md | Adds a Documentation-section link to the new Agent Skill. |
| CHANGELOG.md | Notes the addition of the new skills/mcpls/ Agent Skill under Unreleased. |
Link the README Documentation entry to the skills/mcpls/ directory rather than SKILL.md directly, and clarify that the MCPLS_* env var equivalence applies to the mcpls-specific flags, not --version/--help.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
skills/mcpls/SKILL.mdandskills/mcpls/references/configuration.md, a spec-compliant Agent Skill that teaches an AI coding agent to install, configure, and run themcplsbinary itself (distinct from the MCP tools it exposes once running)MCPLS_*env var table (verified againstcrates/mcpls-cli/src/args.rs), MCP client registration (stdio and gated HTTP transport), the config search order/per-platform paths, the project-config trust model, and troubleshooting pointersNotes
crates/is touchedconfig/mod.rs,error.rs,mcp/server.rs,args.rs) rather than copied from existing docs, and two pre-existing bugs surfaced during that process (--log-jsonis parsed but never consumed; the macOS config-path rustdoc/docs are wrong) — those are out of scope here and will be filed as separate issuesCloses #252
Test plan
skills/mcpls/SKILL.mdfrontmatter validated manually against the agentskills.io spec (name/description/compatibility length limits,metadatastring-map)name: mcplsmatches the parent directory namecrates/mcpls-cli/src/args.rsskills/mcpls/references/(all external links are absolute GitHub URLs, since skills are portable and get copied to~/.claude/skills/)