e4de42cf8d* Add community insights from Discord threads and meeting notes Distill Discord discussions (Feb 14-24) and Feb 26 office hours into existing docs: - New findings: NimbleBrain skill:// resource consolidation, skill reliability/adherence issues across implementations - Expanded approaches with distribution/provenance considerations, resources adoption insight, and domain-level discovery (.well-known) - Expanded open questions on dependencies and distribution trust - Added Cloudflare Agent Skills Discovery RFC and NimbleBrain reference implementations to related work Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * Remove trust note since its already mentioned in the doc separately * Clarify attribution for community insights on skill dependencies in open questions * Refine findings on model skill adherence and community workarounds * Remove outdated comparison section and streamline evaluation insights in experimental findings * Remove unnecessary blank line in experimental findings documentation * Add SEP-2093 proposal to related work documentation --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
6.5 KiB
6.5 KiB
Related Work
Open SEPs and Proposals
| Proposal | Venue | Description |
|---|---|---|
| SEP-2076 | MCP Spec | Agent Skills as a first-class MCP primitive |
| SEP-2093 | MCP Spec | Resource Contents Metadata and Capabilities: scoped resources/list, per-resource capabilities, resources/metadata endpoint |
| skills.json format proposal | MCP Registry | Skills metadata in registry schema |
| Agent Skills Discovery via Well-Known URIs | Cloudflare | Domain-level skill discovery using /.well-known/skills/ (RFC 8615); includes integrity verification and progressive disclosure |
Implementations
Original implementations from external repositories (example implementations in this repo will be added to examples folder):
| Implementation | Author | URL | Notes |
|---|---|---|---|
| skilljack-mcp | Ola Hungerford | github.com/olaservo/skilljack-mcp | Skills as MCP tools, resources, prompts with dynamic updates |
| mcpGraph skill | Bob Dickinson | github.com/TeamSparkAI/mcpGraph | Complex skill example for graph orchestration |
| skills-over-mcp | Keith Groves | github.com/keithagroves/skills-over-mcp | Example using skills as MCP resources with current MCP primitives |
| chrome-devtools-mcp | Anthropic | github.com/anthropics/anthropic-quickstarts/…/chrome-devtools-mcp | Real-world example: skills/ folder requires separate install path |
| NimbleBrain skills repo | NimbleBrain | github.com/NimbleBrainInc/skills | Monorepo with .skill artifact format |
| NimbleBrain registry | NimbleBrain | registry.nimbletools.ai | Registry with skill metadata support |
| FastMCP 3.0 Skills | FastMCP | gofastmcp.com/servers/providers/skills | Native skills provider (#2694) |
| skillsdotnet | Peder HP | github.com/PederHP/skillsdotnet | Exploratory C# implementation compatible with FastMCP 3.0, includes interactive console chat client and sample server |
| PydanticAI Skills | PydanticAI | pydantic/pydantic-ai#3780 | Agent skills with tools-based approach |
| mcp-cli | philschmid | github.com/philschmid/mcp-cli | Wraps MCP servers as CLI for progressive disclosure |
| mcp-execution | bug-ops | github.com/bug-ops/mcp-execution | Compiles MCP servers into skill packages |
| Astronomer agents | Kaxil Naik | github.com/astronomer/agents | Skills distribution via MCP for Apache Airflow |
| my-cool-proxy | karashiiro | github.com/karashiiro/my-cool-proxy | MCP gateway server with skills as resources via Lua scripts |
| Strands Agents MCP server | AWS | github.com/strands-agents/mcp-server | Docs-as-MCP: TF-IDF search + doc fetch |
| AWS MCP server | AWS | docs.aws.amazon.com/aws-mcp/… | retrieve_agent_sop (skills) + call_aws (tool) |
| Kiro powers directory | Kiro | github.com/kirodotdev/powers | Plugin directory bundling skills + MCP servers |
| NimbleBrain skill:// servers | NimbleBrain | github.com/NimbleBrainInc | skill:// resource colocation examples: mcp-ipinfo, mcp-webfetch, mcp-pdfco, mcp-folk, mcp-brave-search |
External Resources
- Agent Skills Standard: agentskills.io
- Anthropic's guidance on progressive disclosure: Equipping agents for the real world with agent skills
- "MCP and Skills: Why Not Both?" (Kurtis Van Gent): kvg.dev/posts/20260125-skills-and-mcp/ — Frames MCP (connectivity) and Skills (context saturation) as complementary; discusses hybrid approaches
- Conceptual spec visualization (Keith Groves): enact-465fb1fc.mintlify.app/specification/draft/server/skills — "What if" exploration
- Apache Airflow AIP-91 (MCP integration): cwiki.apache.org/…/AIP-91+-+MCP
- llms.txt convention: llmstxt.org — Convention for making documentation LLM-accessible; used by MCPDoc in a way similar to how skills work.
- AWS Agent SOPs: docs.aws.amazon.com/…/agent-sops — Pre-built operational workflows as skill-like guidance
- Skill dependency declaration: agentskills/agentskills#110 — Discusses how skills should declare their tool/server dependencies
- Agent Skills Discovery RFC (Matt Silverlock / Cloudflare): github.com/cloudflare/agent-skills-discovery-rfc — Proposes
/.well-known/skills/for domain-level skill discovery using RFC 8615. Defines anindex.jsondiscovery index with progressive disclosure (name/description at discovery time, full SKILL.md on activation), SHA-256 content integrity, and optional archive distribution. Complementary to MCP-level discovery:.well-knownanswers "what skills does this domain publish?" while MCP answers "how does the agent consume them at runtime?" - Video background: youtube.com/watch?v=CEvIs9y1uog