write-setup-authoring-contracts

Author judgment-only Setup Authoring Contracts under setup-assets/blueprints for future Rules and Skills.

Updated May 19, 2026
One-click install
npx skills add https://github.com/wenyue/SmartKit --skill write-setup-authoring-contracts-wenyue
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: write-setup-authoring-contracts
Source: https://github.com/wenyue/SmartKit/tree/main/.agents/skills/write-setup-authoring-contracts
Command: npx skills add https://github.com/wenyue/SmartKit --skill write-setup-authoring-contracts-wenyue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams setting up agent-driven projects need precise, evidence-backed specifications for each future Rule or Skill before generation begins. Without them, downstream setup invents facts, oversteps authority, or produces inconsistent artifacts. This Skill produces the smallest complete set of judgment-only Setup Authoring Contracts that pin down each target's meaning, permissions, outcomes, and stop conditions. ## Core Features & Use Cases - Contract authoring: Writes descriptive contracts under setup-assets/blueprints/** covering objective, actor, trigger, path, owner, obligations, permissions, and observable outcomes for one future Rule or Skill each. - Evidence qualification: Derives every contract fact from accepted user decisions, Issues, Specs, ADRs, and target-owner evidence, with explicit provenance. - Structured stops: Returns ACCESS_REQUIRED, CONTEXT_REQUIRED, or HUMAN_DECISION_REQUIRED when a contract cannot be written safely, instead of inventing facts. - Use Case: Before running setup-project-agents to generate project Rules and Skills, use this Skill to author the blueprint contracts that define exactly what each generated target must mean, permit, and stop on. ## Quick Start Use the write-setup-authoring-contracts skill to author the Setup Authoring Contracts for the accepted targets in this project.

Frequently Asked Questions about write-setup-authoring-contracts

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

FAQPage Schema
How do I author a Setup Authoring Contract for a future Rule or Skill?▼

Provide the accepted task, Candidate, and evidence, then the Skill writes one contract per target under setup-assets/blueprints covering objective, actor, trigger, path, owner, obligations, permissions, and observable outcomes. It first applies the checkout-authoritative writing-for-agents Skill before shaping any contract.

What is a Setup Authoring Contract in SmartKit setup workflows?▼

A Setup Authoring Contract is a judgment-only, descriptive specification for exactly one future Rule or Skill target. It records what the target must mean, permit, validate, return, and stop on, while leaving discovery, ordering, tool choice, and generation mechanics to runtime owners.

Does this Skill generate the actual Rules or Skills?▼

No. It only authors the blueprint contracts and hands them off as ready input to setup-project-agents, which alone owns downstream generation and setup execution. It never writes future targets, shared SmartKit artifacts, commits, or publishes anything.

What happens when evidence or authority is missing during contract authoring?▼

The run stops with a structured result: ACCESS_REQUIRED for inaccessible evidence, CONTEXT_REQUIRED for undiscoverable facts, or HUMAN_DECISION_REQUIRED for choices outside accepted authority. Each stop names the owner, consequence, and conditions needed for a fresh run.

When should I not use contract-based setup authoring?▼

Avoid it when no accepted project intent or qualified evidence exists yet, since contracts must be derived from accepted decisions and authoritative sources. It is also unsuitable for implementation recipes, because contracts are descriptive specifications, not procedural instructions.