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.
Install with Tessl CLI
npx tessl i github:Dicklesworthstone/pi_agent_rust --skill mcporter88
Does it follow best practices?
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillValidation for skill structure
Discovery
85%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a well-structured skill description that clearly defines both capabilities and usage triggers. It excels at specificity and completeness with an explicit 'Use this skill when' clause. The main weakness is that trigger terms are somewhat technical, which may not match how all users naturally phrase requests about MCP functionality.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'list available MCP servers, view tool schemas, call MCP tools, manage OAuth authentication, generate CLI wrappers and TypeScript types'. These are clear, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both what ('Interact with MCP servers using mcporter CLI') and when ('Use this skill when you need to list available MCP servers, view tool schemas, call MCP tools...'). Has explicit 'Use this skill when' clause with specific triggers. | 3 / 3 |
Trigger Term Quality | Includes relevant terms like 'MCP', 'Model Context Protocol', 'mcporter', 'OAuth', 'CLI wrappers', 'TypeScript types', but these are fairly technical. Missing more natural user phrases like 'connect to tools' or 'server integration'. | 2 / 3 |
Distinctiveness Conflict Risk | Very distinct niche focused on MCP/mcporter CLI specifically. The combination of 'MCP', 'Model Context Protocol', 'mcporter', and specific actions like 'OAuth authentication' and 'TypeScript types' makes it unlikely to conflict with other skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted CLI reference skill that excels at conciseness and actionability. The content assumes Claude's competence and provides executable examples throughout. The main weakness is the lack of validation steps or error handling guidance, particularly for authentication flows and daemon management where verification would be valuable.
Suggestions
Add verification steps after key operations (e.g., 'After `mcporter auth <server>`, verify with `mcporter list <server>` to confirm authentication succeeded')
Include common error scenarios and recovery steps, especially for OAuth authentication failures
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient, presenting only CLI commands and syntax without explaining what MCP is or how CLIs work. Every section delivers actionable information without padding. | 3 / 3 |
Actionability | All examples are concrete, copy-paste ready bash commands with realistic arguments. Multiple syntax variations are shown with executable examples rather than descriptions. | 3 / 3 |
Workflow Clarity | The Quick Start provides a clear 3-step sequence, but there are no validation checkpoints or error recovery guidance. For operations like OAuth auth or daemon management, no feedback loops are provided to verify success. | 2 / 3 |
Progressive Disclosure | Content is well-organized into logical sections (Quick Start, Calling Tools, Authentication, Daemon, Code Generation, Tips). For a CLI reference skill of this scope, the structure is appropriate without needing external file references. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
Total | 10 / 11 Passed | |
- Reviewed
Table of Contents
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.