skills.rest
wimpysworld
wimpysworldOFFICIAL
Explore all skills by this author →
WebsiteGitHub

agentic-repo-capability

Adds MCP servers, skills, and commands to repositories across Claude Code, Codex, OpenCode, and Pi.

716|31|Updated Mar 13, 2023
Search Tags:#slash commands#agent tooling#repository configuration#MCP Server#Claude code#Opencode#ai coding clients
One-click install
npx skills add https://github.com/wimpysworld/nix-config --skill agentic-repo-capability
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agentic-repo-capability
Source: https://github.com/wimpysworld/nix-config/tree/main/home-manager/_mixins/agentic/assistants/skills/agentic-repo-capability
Command: npx skills add https://github.com/wimpysworld/nix-config --skill agentic-repo-capability

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Configuring agent tooling like MCP servers, skills, and slash commands differs across AI coding clients, and copying one client's schema to another produces broken or undiscoverable configurations. This Skill guides the correct per-client setup so repository-local capabilities work everywhere they are supported.

Core Features & Use Cases

  • Capability Type Resolution: Distinguishes MCP servers, skills, and commands, then applies the right authoring workflow for each.
  • Cross-Client Configuration: Translates one capability into the native project formats of Claude Code (.mcp.json), Codex (.codex/config.toml), OpenCode (opencode.json), and Pi (.pi/mcp.json).
  • Validation Workflow: Verifies executable availability, file syntax, client discovery, and cross-client consistency using the repository's own dev environment.
  • Use Case: A user asks to add a database MCP server to their repo; the Skill adds the package to the Nix dev shell, writes each client's native config, keeps secrets out of tracked files, and validates discovery.

Quick Start

Ask the agent to add an MCP server, skill, or slash command to this repository for all supported AI coding clients.

Frequently Asked Questions about agentic-repo-capability

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add an MCP server to a repository for multiple AI coding clients?▼

Add the server executable to the repository's development environment, then write each client's native project config: .mcp.json for Claude Code, .codex/config.toml for Codex, opencode.json for OpenCode, and .pi/mcp.json for Pi with the adapter installed. Validate discovery with each client's diagnostic commands.

What is the difference between an MCP server, a skill, and a slash command?▼

An MCP server exposes tools, resources, or prompts through a local process or remote endpoint. A skill supplies reusable guidance clients load by name or description. A command gives users a named, explicit invocation with optional arguments.

Can I copy the same MCP configuration between Claude Code and OpenCode?▼

No, each client uses a different schema. Claude Code uses mcpServers with a string command and separate args array, while OpenCode uses mcp with type local and a combined command array. Translate the intent into each native schema instead of copying.

Does Pi support MCP servers in project configuration?▼

Pi core has no MCP support. Project-level MCP configuration via .pi/mcp.json works only when the pi-mcp-adapter extension is installed, and the adapter shallow-merges project servers over global entries by name.

How do I keep API keys out of MCP configuration files?▼

Keep tokens and passwords out of tracked files by using inherited runtime environment variables or the repository's secret provider. Confirm the client expands variable references before checking them in, and never print resolved secrets during validation.

Related Skills

Explore More Software Engineering Skills→
warpdotdevwarpdotdev
64.7k

verify-ui-change-in-cloud

Spawns a cloud agent with computer use to verify user-facing Warp client changes.

Official
Intermediate
matt-rileymatt-riley
1

acquire-codebase-knowledge

Generate seven documentation templates from verifiable repository data.

Community
Advanced
firebasefirebase
6.3k

developing-genkit-tooling

Codify best practices for authoring Genkit CLI commands and MCP server tools.

Official
Advanced
paulnsorensenpaulnsorensen
1

github-copilot-personal-instructions

Configure and audit GitHub Copilot Personal instructions for Copilot Chat on github.com.

Community
Basic