Skip to content

feat: add second-wave public skills#161

Closed
xiaojiou176 wants to merge 1 commit intoOpenHands:mainfrom
xiaojiou176:codex/add-second-wave-public-skills
Closed

feat: add second-wave public skills#161
xiaojiou176 wants to merge 1 commit intoOpenHands:mainfrom
xiaojiou176:codex/add-second-wave-public-skills

Conversation

@xiaojiou176
Copy link
Copy Markdown

What these skills teach

This PR adds six self-contained public skill packets that teach an agent how to install, attach, verify, and safely use repo-owned MCP surfaces without overclaiming hosted or marketplace state.

  • openui-workspace-delivery
    • teaches local OpenUI MCP attach, safe-first UI generation, quality-gate flow, and review-bundle proof
  • movi-review-first-bundle
    • teaches review-first batch inspection, manifest reads, safe-first analysis, and guarded mutation boundaries
  • switchyard-runtime-diagnostics
    • teaches runtime/provider diagnostics, safe-first catalog reads, and truthful internal-vs-external blocker triage
  • prooftrail-mcp
    • teaches governed browser-evidence MCP attach, read-first proof inspection, and truthful package/listing boundaries
  • shopflow-read-only-packet
    • teaches submission-readiness and packet-truth inspection without fake live store claims
  • prooflane-mcp
    • teaches repo-native MCP attach, governed run/proof inspection, and truthful publish-ready-vs-published boundaries

Why these packets are different from prompt cards

Each skill folder is meant to stand alone for a reviewer or host:

  • SKILL.md teaches the workflow
  • README.md explains what the agent learns
  • manifest.yaml captures current package/listing state
  • references/INSTALL.md shows attach/setup
  • references/OPENHANDS_MCP_CONFIG.json and references/OPENCLAW_MCP_CONFIG.json give host config examples
  • references/CAPABILITIES.md maps the tool surface and safe-first order
  • references/DEMO.md gives a first-success path and expected outcome shape
  • references/TROUBLESHOOTING.md explains where to look when attach or first success fails

Boundaries

These packets intentionally do not claim hosted runtimes, universal live marketplace presence, or publication that has not actually landed.

Notes

  • openui-workspace-delivery, movi-review-first-bundle, switchyard-runtime-diagnostics, shopflow-read-only-packet, and prooftrail-mcp are already live on ClawHub.
  • prooflane-mcp is included here as a truthful repo-native packet even though its ClawHub new-skill publish is currently blocked by the platform's hourly new-skill rate limit.

@xiaojiou176
Copy link
Copy Markdown
Author

Reviewer note:

  • these six packets are meant to read as capability kits, not repo promo pages
  • all six now have explicit install/config/capability/demo/troubleshooting sections
  • openui-workspace-delivery, movi-review-first-bundle, switchyard-runtime-diagnostics, prooftrail-mcp, and shopflow-read-only-packet are already live on ClawHub with fresh read-back
  • prooflane-mcp is in this PR as a truthful packet, but its ClawHub first publish is currently blocked by the platform's hourly new-skill rate limit, not by missing packet content

If you review this PR, the key question should be: does each folder clearly teach what the agent learns, how it installs/attaches the MCP, what the safe-first capability order is, and what the first-success path looks like?

@enyst
Copy link
Copy Markdown
Collaborator

enyst commented Apr 11, 2026

@xiaojiou176 As explained in #154 (comment) , I think you have a simple alternative if you wish to provide skills for OpenHands users: make a custom marketplace.json and distribute it to people. Thank you for the contribution!

@enyst enyst closed this Apr 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants