create-luke-skill

Generate and validate proposal bundles for read-only Luke schema-v1 catalog skills.

Updated Jul 28, 2026
One-click install
npx skills add https://github.com/thinkingoracle/luke-skills --skill create-luke-skill-thinkingoracle
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-luke-skill
Source: https://github.com/thinkingoracle/luke-skills/tree/main/creator/create-luke-skill
Command: npx skills add https://github.com/thinkingoracle/luke-skills --skill create-luke-skill-thinkingoracle

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Contributors to the Luke skills catalog must produce a strictly conformant SKILL.md plus a four-category evaluation fixture before opening a proposal issue, and hand-authoring these artifacts against the schema-v1 rules is error-prone. This Skill scaffolds both files deterministically and validates them with the same validator used by CI. ## Core Features & Use Cases - Deterministic bundle generation: Runs scripts/new_skill.py to emit skills/<slug>/SKILL.md and evals/<slug>.json from flags or a JSON answers file, with rollback and locking on failure. - Schema-v1 validation: Runs scripts/validate.py with --allow-draft-provenance to check the draft bundle against catalog rules before submission. - Boundary enforcement: Supports host-bound, host-free web_search-only, and owned-browser authenticated read shapes while refusing mutations, credentials, and private hosts. - Use Case: A contributor wants to propose a skill that reads a planetarium's public hours page; the creator generates the SKILL.md and evaluation fixture, validates them, and the contributor pastes both into the proposal issue form. ## Quick Start Ask the assistant to create a Luke catalog skill proposal bundle for your read-only public-information task, providing a slug, description, public host, and one positive, negative, failure, and redaction example.

Frequently Asked Questions about create-luke-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Luke catalog skill proposal?▼

Run scripts/new_skill.py from the catalog repository root with a slug, description, optional public host, data-read summary, and four routing examples. It writes skills/<slug>/SKILL.md and evals/<slug>.json, then validate the bundle with scripts/validate.py using --allow-draft-provenance.

What evaluation fixture does a Luke skill proposal require?▼

Each proposal needs an evals/<slug>.json file with at least one case in each of four categories: positive_routing, negative_routing, failure, and redaction. Each case has a stable id, an input, and an observable expected result.

Can a Luke catalog skill require user authentication?▼

Yes, but only for public-host-bound skills whose steps are all read-only delegate_web_action with the owned_browser adapter and no fallback. The user signs in directly in Luke's isolated profile, and the artifact never contains credentials.

When can a Luke skill omit the host field?▼

A routing rule may omit host only when every executable step is read-only web_search. Host-free fetch_url, delegate_web_action, connector, authenticated, or mutating skills are rejected by validation.

Why does the creator fail with CREATOR_ARTIFACT_EXISTS?▼

The creator never overwrites an existing proposal artifact, so it refuses to run when the target SKILL.md or evaluation fixture already exists. Choose a new output root or remove the prior draft before retrying.

What Python version does the Luke skill creator need?▼

The creator requires CPython 3.11 or later and exits with CREATOR_UNSUPPORTED_PYTHON on older versions. Install a supported Python and confirm python3 resolves to it before running the scripts.