mcporter

Interact with MCP (Model Context Protocol) servers using the mcporter CLI. Use this skill when you need to list available MCP servers, view tool schemas, call MCP tools, manage OAuth authentication, or generate CLI wrappers and TypeScript types for MCP servers.

1.29x

Quality

88%

Does it follow best practices?

Impact

88%

1.29x

Average score across 3 eval scenarios

Securityby

Low

Low-risk findings worth noting

Quality

Content

83%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A tight, highly actionable CLI command reference that excels on conciseness and actionability. Its main weakness is workflow clarity: destructive and state-changing commands (auth reset, config remove, daemon stop/restart) appear without any validation or verification guidance.

Suggestions

Add a brief validation/verification note for destructive commands (e.g., run `mcporter daemon status` after `daemon restart`, or confirm with `mcporter list` before `config remove`) to lift workflow clarity above the destructive-operations cap.

Consider moving the full per-command flag reference into a separate REFERENCE.md and keeping SKILL.md as a quick-start overview with one-level-deep links, which would improve progressive disclosure.

Add a short note on expected output or error handling for `mcporter call` so Claude can verify a tool call succeeded rather than assuming success.

Dimension	Reasoning	Score
Conciseness	Lean command reference with no padded concept explanations; every line is an executable command or a brief one-line tip, assuming Claude's competence and earning every token.	5 / 5
Actionability	Fully executable, copy-paste-ready commands covering the common cases (list, call with five syntax variants, auth, config, daemon, code generation), each shown as a concrete bash invocation.	5 / 5
Workflow Clarity	Quick Start provides a clear three-step sequence (list → view schema → call), but the skill includes destructive operations ("auth --reset", "config remove", "daemon stop/restart") with no validation or verification checkpoints, capping the score per the destructive-operations rule.	3 / 5
Progressive Disclosure	Well-organized into clearly headed sections (Quick Start, Calling Tools, Authentication, Daemon, Code Generation, Tips) with content appropriately self-contained for a CLI reference; not a 5 because it is a single monolithic inline reference over 50 lines rather than an overview pointing to one-level-deep materials.	4 / 5
	Total	17 / 20 Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, well-structured description that clearly states the tool, enumerates concrete capabilities, and provides an explicit "Use when" trigger clause. The only minor gap is keyword synonym coverage, which keeps trigger term quality just below the top anchor.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — "list available MCP servers", "view tool schemas", "call MCP tools", "manage OAuth authentication", "generate CLI wrappers and TypeScript types" — giving comprehensive coverage of the tool's capabilities.	5 / 5
Completeness	Explicitly answers both what ("Interact with MCP servers using the mcporter CLI" plus enumerated actions) and when ("Use this skill when you need to...") with concrete trigger phrases.	5 / 5
Trigger Term Quality	Good keyword coverage with natural domain terms ("MCP servers", "call MCP tools", "OAuth authentication", "TypeScript types"), but lacks common synonyms or variations users might say; not a 5 because no file-extension-style triggers or alternate phrasings are present.	4 / 5
Distinctiveness Conflict Risk	Occupies a clear niche — the mcporter CLI for MCP servers — with distinct triggers and minimal overlap risk with other skills.	5 / 5
	Total	19 / 20 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
metadata_version	'metadata.version' is missing	Warning

	Total	15 / 16 Passed

Repository: Dicklesworthstone/pi_agent_rust
Path: tests/ext_conformance/artifacts/agents-mikeastock/skills/mcporter/SKILL.md
Commit: 6453c0b

Reviewed: about 9 hours ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.