Agent skill
execution-types-contract
Keep execution engine changes aligned with stable public types (execution.py + types.py lockstep).
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/execution-types-contract
Metadata
Additional technical details for this skill
- version
- 1
- created at
- 2026-02-01T04:33:04.956Z
- updated at
- 2026-02-01T04:33:04.956Z
SKILL.md
Purpose
When extending execution behavior, keep the public contract stable and import-safe.
When To Use
- You change execution orchestration in
src/vibe_piper/execution.py. - You also add/adjust public result/config types in
src/vibe_piper/types.py.
Procedure
- Decide what is "public API" vs. internal implementation.
- Put public dataclasses/enums/protocols in
src/vibe_piper/types.py. - Keep
src/vibe_piper/execution.pyfocused on orchestration and flow. - Enforce a one-way dependency:
src/vibe_piper/execution.pymay import fromvibe_piper.types.- Avoid
src/vibe_piper/types.pyimporting fromvibe_piper.execution.
- If you need type-only references that would create a cycle, use
typing.TYPE_CHECKINGand forward references. - Prefer narrow, explicit types (dataclasses/enums) over loose dicts for cross-module boundaries.
Manual notes
This section is preserved when the skill is updated. Put human notes, caveats, and exceptions here.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?