action-skill-contracts
Author deterministic skills for operations that change state or invoke external tools
- License 许可
- MIT
- 所属仓库
- github/squad
- 最近更新
- 2026-11-15
- Stars
- ★ 3.4k
- Forks
- 520
01 前言 Front Matter
- name
- action-skill-contracts
- domain
- prompt-architecture, operations
- source
- retained prompt-architecture lessons reconciled with current skill conventions
- confidence
- high
- description
- Author deterministic skills for operations that change state or invoke external tools
03 SKILL.md 正文
Context
Use this skill when authoring or revising a skill that can mutate files, state, repositories, or external systems. Informational reference skills need not carry operational ceremony.
Patterns
- Start with an explicit
## SCOPE: activation conditions, allowed targets, and exclusions. - Provide an ordered, deterministic workflow. State required inputs, the intended side effect, and the exact validation after each consequential operation.
- Define STOP conditions for missing prerequisites, ambiguous scope, failed verification, and unavailable tools. A failed precondition must not look like success.
- Point to a current canonical implementation or workflow when a procedure depends on repository behavior; do not copy volatile values into prose.
- Keep one skill focused on one operational boundary. Link to related skills rather than combining unrelated governance, release, and documentation procedures.
Examples
archival-integrity defines a verified append-before-trim transaction. gh-aw-enlistment limits
mutations through an explicit allowlist and ends with strict compilation.
Anti-Patterns
- Vague verbs such as “handle,” “ensure,” or “fix” without an observable success condition
- Side effects that proceed after a failed validation
- Treating a dated incident workaround as a permanent procedure without reconciling source
- Adding action ceremony to a purely explanatory skill
04 同仓库更多 Skills
windows-compatibility
Cross-platform path handling and command patterns
versioning-policy
SemVer rules for Squad's stable, preview, insider, and local package versions
tiered-memory
Three-tier agent memory model (hot/cold/wiki) for context reduction per spawn
test-discipline
Design assertions that prove the actual contract and fail on realistic regressions
squad
Squad's command catalog and interactive menu. Invoke via /squad (slash command) or natural language ("squad commands", "what can squad do", "show me squad options"). Presents categorized operations (Install & Upgrade, Team Management, Issues & PRs, Plugins & Skills, Model & Cost, Sessions & State) as an interactive picker. Routes to the right squad CLI command or the Squad coordinator agent.
squad-version-check
Internals of how @bradygaster/squad-cli stamps its version, how `squad upgrade` works (what it preserves vs overwrites), and how to probe the npm registry for the latest version from a coordinator prompt.