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

—

Does it follow best practices?

Impact

88%

1.29x

Average score across 3 eval scenarios

Securityby

Advisory

Suggest reviewing before use

Quality

Content

92%

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

A concise, highly actionable CLI reference with a clear core workflow. Its main weakness is progressive disclosure: the entire command catalog lives inline in SKILL.md with no offloaded reference material.

Suggestions

Move the detailed command catalogs (Calling Tools variants, Authentication/Configuration, Daemon, Code Generation) into a references/COMMANDS.md file, leaving SKILL.md as a concise overview with well-signaled links.

Add a one-level-deep reference pointer (e.g. "See [COMMANDS.md](references/COMMANDS.md) for the full command reference") so detailed material is opt-in rather than always loaded.

Keep only the Quick Start sequence and the highest-frequency commands inline, externalizing the less-common invocations to keep SKILL.md under the simple-skill scope.

Dimension	Reasoning	Score
Conciseness	The body is lean and code-block-driven with minimal prose and no explanation of concepts Claude already knows, so every token earns its place.	3 / 3
Actionability	Commands are concrete and executable (e.g. "mcporter call linear.list_issues team=ENG limit:5", "mcporter emit-ts <server> --mode client") and copy-paste ready across all sections.	3 / 3
Workflow Clarity	Quick Start sequences the core workflow (list servers → view tools → call a tool) and the skill involves no destructive/batch operations that would require validation checkpoints, satisfying the simple-skill allowance.	3 / 3
Progressive Disclosure	Content is well-organized into sections but is a ~92-line inline command catalog with no external reference structure or split, exceeding the simple-skill threshold where progressive disclosure can score 3 on sections alone.	2 / 3
	Total	11 / 12 Passed

Description

100%

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 description that concisely names the tool, lists concrete capabilities, and provides an explicit Use-when trigger clause. It is distinctive and unlikely to be invoked for the wrong skill.

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" — matching the multiple-specific-actions anchor.	3 / 3
Completeness	Explicitly states what ("Interact with MCP servers using the mcporter CLI") and when via an explicit "Use this skill when you need to…" trigger clause, matching the both-what-and-when anchor.	3 / 3
Trigger Term Quality	Natural domain terms users would say (MCP servers, tool schemas, call MCP tools, OAuth authentication, TypeScript types) with good coverage across capabilities; not merely jargon.	3 / 3
Distinctiveness Conflict Risk	Niche is specific and clearly bounded to MCP server interaction via the mcporter CLI, with distinct triggers unlikely to overlap with unrelated skills.	3 / 3
	Total	12 / 12 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
Commit: abece4a

Reviewed: 3 days 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.