UXC Skill Creator

Use this skill to design and standardize provider wrapper skills built on top of uxc.

Prerequisites

• uxc skill is available as the base execution contract.
• Target wrapper skill scope is clear (provider endpoint, core operations, auth model, write risk).

Output Contract

A wrapper skill created with this skill should include:

• SKILL.md
• agents/openai.yaml
• references/usage-patterns.md
• scripts/validate.sh

Optional files are allowed only when they add real reusable value.

Core Workflow

1. Start from user-provided host input:

- record the raw host the user gives - normalize endpoint candidates (scheme/no-scheme, path variants)

1. Discover protocol and valid path before drafting skill text:

- search official docs/repo to confirm endpoint shape and auth model - probe candidates with uxc <endpoint> -h - confirm one working endpoint + protocol as the wrapper target

1. Detect authentication requirement explicitly:

- run host help or a minimal read call and inspect envelope/error code - if auth-protected, record required model (api key or oauth) and scopes - verify local mapping path with uxc auth binding match <endpoint> when OAuth/binding is used

1. Fix the wrapper interface:

- provider endpoint (<host>) - fixed link command name (<provider>-<protocol>-cli) - auth mode (none, api key, oauth)

1. Write SKILL.md as a thin execution policy:

- link-first command flow - help-first discovery flow - JSON envelope parsing and safe-write guardrails

1. Add provider-specific references/usage-patterns.md:

- minimal read and write examples - key=value and bare JSON positional input examples

1. Add scripts/validate.sh with strict checks:

- required files - frontmatter fields - command style constraints - banned legacy patterns

1. Add agents/openai.yaml for skill UI metadata.
2. Run validation and iterate until clean.

Hard Rules

• Default to link-first (command -v <linkname> then uxc link <linkname> <host>).
• Default to help-first (<linkname> -h, <linkname> <operation> -h).
• Use protocol-aware link naming:

- format: <provider>-<protocol>-cli - examples: notion-mcp-cli, github-openapi-cli

• Prefer key=value; allow bare JSON positional payload.
• Keep JSON output as automation path; do not rely on --text.
• Do not use legacy default examples (list/describe/call/removed flags).
• Do not use dynamic link renaming at runtime.
• Do not assume protocol/path/auth from host string alone; verify by search + probe.

References

• Step-by-step implementation flow:

- references/workflow.md

• Copy-ready templates:

- references/templates.md

• Validation checklist and banned patterns:

- references/validation-rules.md

• Observed pitfalls and better defaults:

- references/anti-patterns.md

See Also

• Base execution and protocol/auth guidance:

- skills/uxc/SKILL.md