ext-skills/docs
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Ola Hungerford b5c70cbbd4
Reorganize related-work.md by contributor role and add skillful-mcp (#76)
* Reorganize related-work.md to separate IG member work from community and ecosystem

The flat implementations list mixed IG facilitator/participant work with
community adoptions and tangentially related ecosystem projects, making it
hard to see which implementations are actively shaping the group's direction.

Changes:
- Split "Implementations" into "IG Member Implementations", "Community
  Implementations", and "Related Ecosystem Work" sections
- Add Organization column to IG member table for clearer attribution
- Add skillful-mcp (Kurtis Van Gent / Google Cloud) as IG member impl
- Update my-cool-proxy attribution to Jack Tysoe / Kong
- Split "External Resources" into "Specifications and Standards" and
  "Background Reading"
- Move Cloudflare RFC from Open SEPs to Specifications (it's a published
  spec, not a proposal to this group) and update to v0.2.0 with correct
  path (/.well-known/agent-skills/)
- Update implementation notes with recent version/feature info

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Rename section header from "Community Implementations" to "Other Community Implementations" for clarity in related work documentation

* Fix my-cool-proxy attribution and move to community implementations

karashiiro (Kara) is not Jack Tysoe from Kong — incorrectly conflated
the two based on "MCP gateway" mention in meeting notes. Move
my-cool-proxy back to community implementations with correct author.

Also incorporates the section rename to "Other Community Implementations"

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Move NimbleBrain to community implementations

NimbleBrain (Mathew Goldsborough) has one comment on the IG repo and was
referenced in the inaugural meeting notes, but hasn't attended meetings
or filed issues/PRs. Better categorized as a community implementation.

Kurtis Van Gent stays in IG member table — he's an MCP core maintainer.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Separate IG member work by alignment with core patterns

After reviewing the actual implementations against the IG's direction
(SKILL.md frontmatter, skill:// URIs, progressive disclosure via MCP
primitives), three repos directly implement those patterns while three
take alternative approaches worth documenting separately.

Core pattern implementations:
- skilljack-mcp: full SKILL.md + skill:// + progressive disclosure + dynamic updates
- skills-over-mcp: SKILL.md + skill:// resources + Zod validation
- skillsdotnet: SKILL.md + skill:// + load_skill tool + NuGet published

Alternative approaches (still by IG members):
- skillful-mcp: progressive disclosure via tools wrapping MCP servers (no SKILL.md)
- astronomer-agents: production SKILL.md catalog via plugin marketplace (not MCP resources)
- mcpGraph: tool orchestration engine with SKILL.md as docs (not runtime skills)

Also enriched implementation notes with specific technical details from
code review rather than surface-level descriptions.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Rename section to 'Alternative Approaches' — Kurtis is MCP maintainer, not IG member

skillful-mcp is by Kurtis Van Gent, an MCP core maintainer who has
commented on IG work and written a relevant blog post, but is not an
IG member. Broaden the heading to include MCP maintainers alongside
IG members.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Add PR #2527 (model access to resources) to Open SEPs

This spec PR recommends clients expose resource read to models, which
is a prerequisite for the resources-based skills approach. Discussed in
the April 7 IG meeting as a primary blocker — skills as resources only
work if models can actually read them.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-13 17:51:10 -07:00
..
approaches.md Define well-known URI schemes and naming patterns for skill resources (#53) 2026-03-12 16:35:39 +00:00
decisions.md Define _meta scoping guidelines for skill resources (#60) 2026-04-08 06:36:13 -07:00
experimental-findings.md Add notes to docs from Discord and office hours discussions (#36) 2026-03-03 12:12:01 -08:00
open-questions.md Add notes to docs from Discord and office hours discussions (#36) 2026-03-03 12:12:01 -08:00
problem-statement.md Add why-and-when doc: value proposition and decision guide (#62) 2026-03-17 06:25:30 -07:00
related-work.md Reorganize related-work.md by contributor role and add skillful-mcp (#76) 2026-04-13 17:51:10 -07:00
skill-meta-keys.md Define _meta scoping guidelines for skill resources (#60) 2026-04-08 06:36:13 -07:00
skill-uri-scheme.md Define well-known URI schemes and naming patterns for skill resources (#53) 2026-03-12 16:35:39 +00:00
use-cases.md Add notes to docs from Discord and office hours discussions (#36) 2026-03-03 12:12:01 -08:00
why-and-when.md Add why-and-when doc: value proposition and decision guide (#62) 2026-03-17 06:25:30 -07:00