write-rules-and-skills

Orchestrates multi-role authoring and review workflows for Rules and Agent Skills.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing or revising governance Rules and Agent Skills requires consistent quality, fidelity to user intent, and regression safety, which ad-hoc editing cannot guarantee. This Skill enforces a structured Controller-Author-Reviewer workflow with fingerprinted baselines, automated validation, and up to three review rounds before a Candidate can be accepted. ## Core Features & Use Cases - Role-based workflow: Separates Controller (task alignment and briefs), Author (sole writer of the Candidate), Quality/Change/Correctness Reviewers, and Runner (bounded runtime evidence collection), each with its own contract in references/. - Fingerprint-gated acceptance: Captures a Candidate baseline and fingerprint via a Python CLI, freezes write scope and validation commands, and only completes when all three review perspectives return PASS on the same fingerprint. - Review topology selection: Chooses Integrated Review for closed, low-risk tasks or Independent Review for high-risk, self-hosting, or security-sensitive changes, with escalation from integrated to independent review. - Use Case: When revising a repository's dependency lockfile Rule, the Controller freezes the scope, an Author rewrites it against accepted requirements, three reviewers independently check quality, semantic regression, and correctness, and the change only ships after automated validation passes on the final fingerprint. ## Quick Start Use the write-rules-and-skills skill to revise the existing Rule at rules/dependency-lockfile.md so it also covers monorepo package managers.

Frequently Asked Questions about write-rules-and-skills

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

FAQPage Schema
How do I write or revise an Agent Skill with a review process?▼

Invoke this workflow with a target Candidate path. A Controller aligns the task and builds an Author brief, a single Author writes the Candidate, and Quality, Change, and Correctness reviewers must all return PASS on the same fingerprint before completion.

What is the difference between Integrated and Independent Review?▼

Integrated Review assigns all three perspectives (Quality, Change, Correctness) to one reviewer for closed, low-risk tasks. Independent Review uses three separate reviewers for high-risk, self-hosting, or security-sensitive changes, and an integrated reviewer can escalate to independent review.

When should I use a Rule versus a Skill for governance content?▼

Rules own continuously applied policy domains with clear boundaries, while Skills own triggered tasks with defined outcomes. The workflow's shared judgment standard assigns each policy to the most appropriate existing owner and keeps one full definition per policy.

Can this workflow publish, commit, or install the artifacts it writes?▼

No. The workflow explicitly does not grant publishing, installation, commit, push, release, translation, or network access permissions. It only produces the Candidate artifact; downstream operations require separate user authorization.

What happens if a review round finds blocking issues?▼

The Author performs one coherent fix per round, the fingerprint is recaptured, and automated validation reruns before re-review. A maximum of three rounds is allowed; unresolved blocking findings after the third round return BLOCKED.