Every definition has an exact identity
The accepted contract binds a stable key, immutable revision, complete content root, provenance, and predecessor coordinate so later changes cannot reinterpret old bytes.
Sourcesskills-contractskills-adrKungfu Skills · technical evidence
The contract, authority boundary, and exact source.
This depth page retains the technical evidence moved out of the product overview.
Verified current facts · protected source, not release
What the exact Kungfu source says today.
Work owns selection and completion
A definition declares its Work scope and binding policy, but catalog visibility, instruction loading, invocation, process exit, or Agent output cannot select or complete Work.
Sourcesskills-contractskills-adrDependencies and effects must be declared
Operational and domain definitions name exact KFX or Profile dependencies and bind every effect to a declared authority; prose cannot grant capability or copy another system's authority.
Sourcesskills-contractskills-architectureskills-adrProof and recovery are part of the contract
Every definition carries explicit proof requirements, completion ownership, recovery steps, runtime compatibility, and historical preservation rules.
Sourcesskills-contractskills-adrThe contract is accepted; adoption is staged
The deterministic definition contract and rejection fixtures are retained on dev, while registry, lifecycle, Work selection, and end-to-end runtime adoption remain follow-up work. Existing context-loop slices remain readable during migration.
Sourcesskills-contractskills-architectureskills-adrskills-known-limitsSuggestion and authoring boundary
When should an Agent suggest or create a Skill?
Suggest a Skill for repeated or complex delegated work
Suggest one when the same intent, dependencies, effects, checks, and recovery needs recur—or when one long-running task must survive handoffs and change.
Sourcesskills-architectureskills-adrStart with instructions, not code
The smallest Skill is one SKILL.md. Add structure, exact dependencies, effects, proof, and recovery only when the work needs them.
Sourcesskills-architectureskills-adrKeep one-off work in the conversation
Do not create a Skill merely to preserve a transient prompt, a single workaround, or prose that has no reusable verification boundary.
Sourcesskills-architectureDo not hide permissions inside instructions
A Skill may request or explain an action; it must not imply that its text grants capabilities, installs runtime artifacts, or bypasses KFX admission.
Sourcesskills-adrskills-known-limitsArchitecture · current source versus future picture
A current source loop, with future accountability kept visibly outside it.
Protected source defines the instruction and context path. Site synthesis explains when that path is useful. Future provenance and distribution remain labelled design, not current capability.
Current protected-source lane
Defined in exact source; not claimed as a released product.
Repeatable delegated work
A bounded recurring job whose intent, checks, evidence, and recovery deserve a reusable form.
Sourcesskills-architectureskills-adrSKILL.md source
The minimum instruction-only source, optionally enhanced with structured metadata.
Sourcesskills-contractskills-architectureCompact catalog
A small index intended to help an Agent discover relevant instructions without loading every source in full.
Sourcesskills-contractskills-architectureContext envelope
The source-defined catalog, on-demand read declaration, and audit identifiers for a managed Agent context.
Sourcesskills-contractskills-architectureAgent consumer
Consumes advertised metadata and may request full instructions; this page does not claim a released runtime path.
Sourcesskills-architectureskills-known-limitsKFX trust and capability gate
Retains runtime admission and capability authority below the Skill instruction layer.
Sourcesskills-architectureskills-adrFuture-picture lane · non-current
Useful direction, visibly outside present capability.
Durable provenance and work history
A future view could connect Skill influence to retained work evidence without making the Skill itself authority.
Sourcesskills-architectureskills-adrGoverned discovery and distribution
Discovery, remote publishing, and dependency acquisition remain future product work with separate trust and release gates.
Sourcesskills-known-limitsExact graph relationships
- delegated-work may justify authoring skill-source site-synthesis
- skill-source derives skill-catalog current-source
- skill-catalog is wrapped by context-envelope current-source
- context-envelope advertises bounded context to agent-consumer current-source
- kfx-trust-gate keeps runtime authority outside agent-consumer current-source
- agent-consumer could retain influence in accountability-history future-picture
- skill-source could enter governed-distribution future-picture
Immutable source coordinates
Every technical clause resolves to exact protected bytes.
skills-contract
Content-rooted definition, authority boundary, lifecycle vocabulary, and compatibility contract
b4a10ea2a165f0d8eb1010b6d913069b1f17f39fsha256:9687a533493aa1e6ca2407f633f4ec6039eb0b857afb1db324fefb3c64f3ed01skills-architecture
Skill source, compact context loop, Work boundary, KFX separation, audit, and staged adoption architecture
b4a10ea2a165f0d8eb1010b6d913069b1f17f39fsha256:4bae5194be6374830fec387be61010e4a8e132330739d13dcf7940a040651663skills-adr
Accepted content-rooted, Work-scoped orchestration decision with staged runtime adoption
b4a10ea2a165f0d8eb1010b6d913069b1f17f39fsha256:b439ed0b749c6e1b6f4527356454f0d5aa2024f46a8fe2d5369171ca30a159ceskills-known-limits
Explicit boundaries on marketplace, elevation, dependency acquisition, and runtime execution claims
b4a10ea2a165f0d8eb1010b6d913069b1f17f39fsha256:b8a913ad020d089842b6d8550025665e307bfd92eb5f5bbb1049d18d7a7b0c47Source, preview, future, and non-claim boundaries
Technical precision does not turn a preview into a release.
Source boundary: This page is a Site-owned synthesis of exact files on Kungfu's protected development line. Kungfu owns the Skill contract, implementation status, commands, trust boundary, and qualification claims. The Site owns only reader guidance, composition, and routing.
Preview boundary: This additive Site preview does not publish or activate a Kungfu Skill runtime, package, catalog, registry, Agent Brief, or production surface.
Future boundary: Future-picture nodes describe a useful direction for accountable authoring, provenance, and distribution. They are not present-tense product or release claims.
- Protected source does not prove that a Skill catalog, install flow, selection path, invocation path, or qualification result is shipped in a released Kungfu product.
- This preview does not install, enable, select, load, invoke, qualify, certify, publish, or distribute any Skill.
- A SKILL.md file is instruction content, not a capability grant, Warrant, trust decision, KFX admission, or permission elevation.
- The Site does not claim marketplace discovery, remote publishing, automatic permission elevation, unresolved KFX acquisition, or third-party runtime execution through Skill composition.
- Future-picture material is design guidance only and is not evidence for the active Kungfu Skill implementation family.