generic-skill-creator
Generic example for creating or updating a Codex skill with appropriate resources, metadata, validation, and forward-testing. Use for generic skill creator, create a skill, update a skill, skill creator, skill authoring, SKILL.md, agents/openai.yaml, init_skill.py, quick_validate.py, forward-test a skill, progressive disclosure and bundled resources. Use when the task needs to create a new Codex skill, update an existing skill, validate a skill folder, generate agents/openai.yaml metadata and forward-test a skill with subagents. Requires `skillspec decide` before substrate tools or overlapping low-level skills. Preserves evidence with SkillSpec routes, forbids, dependencies, traces, and token-savings reports
modiqo · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add modiqo/skillspec --skill generic-skill-creator技能说明
name: generic-skill-creator
description: "Generic example for creating or updating a Codex skill with appropriate resources, metadata, validation, and forward-testing. Use for generic skill creator, create a skill, update a skill, skill creator, skill authoring, SKILL.md, agents/openai.yaml, init_skill.py, quick_validate.py, forward-test a skill, progressive disclosure and bundled resources. Use when the task needs to create a new Codex skill, update an existing skill, validate a skill folder, generate agents/openai.yaml metadata and forward-test a skill with subagents. Requires skillspec decide before substrate tools or overlapping low-level skills. Preserves evidence with SkillSpec routes, forbids, dependencies, traces, and token-savings reports"
Generic Skill Creator
Example SkillSpec-backed contract for creating, updating, validating, and forward-testing Codex skills without colliding with the canonical skillspec-creator skill.
Entry Gate
- Before any task action, run
skillspec plan ./skill.spec.yml --input='<user task>' --trace-dir "${PWD}/.skillspec/traces", preserve the printedrun_dir, then runskillspec act ./skill.spec.yml --input='<user task>' --run <run_dir> --phase <phase-id>, and read the ordered phase plan plus current-route action checklist. - Until that plan and checklist are read, the only allowed actions are loading this
SKILL.md, loading the colocatedskill.spec.yml, and running SkillSpec navigation or decision commands for this spec. - The selected route and matched rules in the checklist override lower-level skill defaults. If a tool is forbidden, stop and report that the SkillSpec blocks it.
- After each phase action, record structured progress in
<run_dir>/execution.jsonland runskillspec progress show ./skill.spec.yml --run <run_dir>before moving to the next phase. - Forbidden before the decision: create_skill_files_before_understanding_examples, run_init_skill_without_user_location_or_default, forward_test_with_leaked_expected_answer.
This skill is a thin loader for the colocated skill.spec.yml. The spec is the source of truth for routes, rules, dependencies, imports, resources, recipes, tests, and trace requirements. Do not treat the spec as background prose; treat it as the execution contract for this task.
Runtime Contract
-
Load
./skill.spec.ymlfrom this skill folder before taking task actions. -
When the
skillspecCLI is available and the spec shape is unfamiliar, runskillspec sensemake ./skill.spec.yml --view indexto learn the section roles, counts, query handles, and navigation grammar without dumping the full YAML. -
Then create the ordered phase plan and current-route action checklist:
skillspec plan ./skill.spec.yml --input='<user task>' --trace-dir "${PWD}/.skillspec/traces" skillspec act ./skill.spec.yml --input='<user task>' --run <run_dir> --phase <phase-id> -
Strip skill invocation prefixes such as
/my-skill,$my-skill, or/durable-executor-specbefore passing--input. -
Preserve the emitted trace
run_dir. -
Read the full phase plan and action checklist before using tools. Treat them as the active execution SOP, not as advice. The
PHASE TOOL BOUNDARY - HARDsection is the permission boundary for the next action. -
For each execution phase, run
skillspec act ./skill.spec.yml --input='<user task>' --run <run_dir> --phase <phase-id>before acting, record phase progress in<run_dir>/execution.jsonl, then runskillspec progress show ./skill.spec.yml --run <run_dir>to see completed, current, blocked, and remaining phases. -
Pull active details with
skillspec query ./skill.spec.yml <handle> --view summaryand relationship edges withskillspec refs ./skill.spec.yml <handle> --view summary. Prefer precise handles such asrule:<id>,rule:<id>.forbid,command:<id>.requires, andstate:<id>.nextover reading the whole spec. -
Before every substrate/tool call, apply the phase tool boundary and checklist allow/deny questions. Any unlisted tool, data source, execution substrate, provider, adapter, CLI, browser mode, API, or skill requires explicit user permission before use. The selected route and matched rules override lower-level skill defaults and generic tool preferences.
-
When the CLI is available after a trace exists, run
skillspec trace align ./skill.spec.yml --decision-trace <run_dir>and, when structured action evidence exists, add--execution-trace <run_dir>/execution.jsonl. The command writes<run_dir>/alignment.json; report the alignment status, meaning, model layers, evidence gaps, user-facing proof rows, summary, and trace path. -
If
skillspec plan,skillspec act, orskillspec progressis unavailable, fall back toskillspec decide, then manually construct the same ordered phase checklist and progress notes before using tools. If the CLI is unavailable, readskill.spec.ymldirectly and apply the same contract manually. Do not expand this loader into a second source of truth.
Authoring And Revision Contract
When importing, creating, revising, or extending this SkillSpec-backed skill, use the embedded grammar teacher before editing skill.spec.yml:
skillspec grammar sensemake --view index
skillspec grammar sensemake --view porting
skillspec grammar checklist --for import-skill
- Treat the checklist as the review gate for semantic edits: activation, routes, rules, elicitations, imports/resources, commands/deps, procedures, tests, proof, and contract quality.
- Fill or update a coverage matrix with
prose_span | obligation | skillspec_construct | confidence | status | review_notebefore installing or releasing a changed skill. - Use
skillspec grammar schema --jsonwhen a harness needs the exact embedded JSON schema. - Do not patch YAML by memory when the binary can teach the current grammar. Run the grammar commands again after CLI upgrades or when a spec shape is unfamiliar.