Skip to content

Add worked examples for multi-server composition and progressive disclosure use cases #45

@olaservo

Description

@olaservo

Background

Use Cases 3 (Multi-Server Composition) and 4 (Progressive Disclosure) are two of the most discussed scenarios in this IG, but the documentation currently lacks concrete, worked examples. Contributors and newcomers need detailed scenarios to understand the problems and evaluate approaches.

Scope

Multi-Server Composition (UC #3)

Add a worked example showing:

  • A skill that orchestrates tools from 2-3 different MCP servers (e.g., "Research and summarize" using a web-search server + a note-taking server + a file-system server)
  • The skill's SKILL.md content with tool references
  • How dependency declaration would work (referencing OQ Add Rado's GitHub handle to Facilitators table #4)
  • What happens when one required server is unavailable

Progressive Disclosure (UC #4)

Add a worked example showing:

  • A complex skill broken into linked files (overview -> detailed steps -> reference)
  • The resource listing showing the skill hierarchy
  • The loading sequence: agent reads overview, requests detailed steps on demand
  • Context management: how much context is consumed at each stage

Version-Adaptive Content (UC #8)

Add a worked example showing:

  • A skill that detects framework version and returns appropriate guidance
  • Implementation sketch using resource templates: skill:///airflow-guide?version={detected_version}

Acceptance Criteria

References

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationenhancementNew feature or request

    Type

    No type

    Projects

    Status

    Backlog

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions