Awesome-omni-skill progressive-discovery

Progressive disclosure pattern for MCP tools and skills. Teaches agents just-in-time discovery to minimize token usage.

install

source · Clone the upstream repo

git clone https://github.com/diegosouzapw/awesome-omni-skill

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/product/progressive-discovery" ~/.claude/skills/diegosouzapw-awesome-omni-skill-progressive-discovery && rm -rf "$T"

manifest: skills/product/progressive-discovery/SKILL.md

source content

Skills & Discovery

Skills — context-aware prompts for common workflows.

Browse:
```
list_skills()
```
on
```
gobby-skills
```
Load:
```
get_skill(name="skillname")
```
on
```
gobby-skills
```

Search:

search_skills(query="topic")

gobby-skills

Hubs:
```
search_hub(query)
```
on
```
gobby-skills
```

MCP Tools — progressive disclosure (each step gates the next):

```
list_mcp_servers()
```
— discover servers (~50 tokens)
```
list_tools(server_name)
```
— discover tools (~100 tokens per server)
```
get_tool_schema(server_name, tool_name)
```
— get full inputSchema (just-in-time)

call_tool(server_name, tool_name, arguments)

— execute

Core principle: NEVER load all schemas upfront — 50+ tool schemas consume 30-40K tokens. Fetch schemas only when you're about to call a tool. This reduces token usage by ~95%.

Common Mistakes

# WRONG — Loading everything upfront (wastes 30-40K tokens)
for server in servers:
    for tool in list_tools(server):
        get_tool_schema(server, tool)  # Unnecessary!

# WRONG — Guessing parameters without schema
call_tool("gobby-tasks", "create_task", {"name": "Fix bug"})  # Wrong param!

# RIGHT — Just-in-time discovery
get_tool_schema("gobby-tasks", "create_task")  # Learn: needs "title" not "name"
call_tool("gobby-tasks", "create_task", {"title": "Fix bug", "session_id": "#123"})

Available Internal Servers

Server	Purpose
`gobby-tasks`	Task management
`gobby-sessions`	Session handoff
`gobby-memory`	Persistent memory
`gobby-workflows`	Workflow control
`gobby-agents`	Agent spawning
`gobby-worktrees`	Git worktrees
`gobby-clones`	Repository clones
`gobby-merge`	Merge resolution
`gobby-hub`	Hub / cross-project
`gobby-skills`	Skill management
`gobby-metrics`	Usage metrics
`gobby-artifacts`	Artifact storage
`gobby-pipelines`	Pipeline execution

Use

list_mcp_servers()

to see all connected servers with live status.