python-verbs-failure

Detects seven failure patterns in Python model verb and derivation implementations.

Updated Jul 15, 2026
One-click install
npx skills add https://github.com/kyzobuild/kyzo-python --skill python-verbs-failure-kyzobuild
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: python-verbs-failure
Source: https://github.com/kyzobuild/kyzo-python/tree/main/cursor/skills/python-verbs-failure
Command: npx skills add https://github.com/kyzobuild/kyzo-python --skill python-verbs-failure-kyzobuild

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Python model methods often get written wrong: stub bodies left as NotImplementedError, multiple construction statements in one verb, signatures drifted from their modeled rows, or undecorated methods on frozen models. This Skill identifies these seven failure patterns so behavior is built as proper verbs and derivations instead. ## Core Features & Use Cases - Stub Detection: Flags verb bodies containing raise NotImplementedError, pass, or bare ellipsis as missing expansions rather than TODOs. - Construction Integrity: Catches verbs with multiple top-level construction statements and enforces the single-construction rule. - Surface and Chain Validation: Detects signatures drifted from the modeled verb row, unmodeled methods, missing modeled verbs, undecorated methods on frozen models, and bodies that skip declared constructs/emits participants. - Use Case: While writing a settle method on a frozen Pydantic model, the Skill fires when you leave a NotImplementedError stub and directs you to construct the Receipt and re-point the state field as the verb row declares. ## Quick Start Review this Python model class and flag any verb or derivation that violates the verb failure patterns.

Frequently Asked Questions about python-verbs-failure

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

FAQPage Schema
How do I fix a Python method that raises NotImplementedError in a model?▼

A verb body of raise NotImplementedError, pass, or bare ellipsis is a missing expansion, not a TODO. Replace the stub with the work the verb row declares: construct the declared fact, re-point the state field to it, and emit it through a client field.

What is the single construction rule for Python model verbs?▼

A verb body holds at most one top-level construction statement, with constituents constructing inside that single call. Building a constituent in a separate statement beside the composite restates what the composite's call already proves.

When should a method on a frozen Pydantic model use @property?▼

A fact implied by a frozen model's already-proven fields is a derivation and must be decorated with @property, @cached_property, or @computed_field. Use @property for cheap recomputation, @cached_property for costly or recursive computation, and @computed_field to include the fact in the serialized shape.

Why does a yielding verb need an Iterator return annotation?▼

A verb's signature must render its modeled row exactly, so a yielding verb must be typed as AsyncIterator or Iterator of the fact it yields. A plain return annotation on a yielding verb is surface drift from the row's declared type.

What happens when a verb body skips a declared emits participant?▼

The body must realize exactly the chain the row declares: construct every constructs participant and emit every emits participant. A promised participant the body never touches is promised work undone, and the body must construct and emit it.