write-principle

Create and review Canon principles with enforced frontmatter and body structure.

6|1|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/micherra/canon --skill write-principle
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-principle
Source: https://github.com/micherra/canon/tree/main/skills/canon/skills/write-principle
Command: npx skills add https://github.com/micherra/canon --skill write-principle

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Canon governance for writing, reviewing, and applying principles, conventions, and agent rules is inconsistent without a unified contract. This skill defines the formal format, roles, and enforcement expectations to ensure reliable, auditable governance across writers and agents.

Core Features & Use Cases

  • Establishes a structured contract for creating, editing, and applying Canon principles, conventions, and agent-rules.
  • Guides mode selection (new-principle, new-agent-rule, edit, apply-proposal) and ensures consistent frontmatter and body structure.
  • Provides validation, versioning, and conflict-checking workflows for safe evolution of governance content.

Quick Start

Provide a principled entry by following the write-principle workflow to create a compliant entry with required frontmatter and sections.

Frequently Asked Questions about write-principle

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

FAQPage Schema
How do I create a Canon principle with the correct frontmatter schema?

Creating a Canon principle requires enforcing a frontmatter schema with name and description fields, plus a standardized body containing summary, rationale, examples, exceptions, and verification sections.

What is the standardized structure for writing agent rules and governance principles?

The standardized structure for agent rules and governance principles requires specific frontmatter fields like name and description, paired with a body that includes summary, rationale, examples, exceptions, and verification for reliable auditing.

How do I manage edits and apply proposals to existing governance principles?

You can manage edits and apply proposals to existing governance principles by selecting the edit or apply-proposal mode to ensure consistent frontmatter, perform validation, and execute conflict-checking workflows for safe content evolution.

Can I use this to enforce validation and versioning for agent rules across writers and operators?

Yes, you can enforce validation, versioning, and conflict-checking workflows for agent rules across writers, reviewers, and operators to ensure reliable, auditable governance content without inconsistency.

What is the best way to automate structured governance for conventions and agent rules?

The best way to automate structured governance for conventions and agent rules is by applying a unified contract that guides mode selection and enforces a formal format with frontmatter and body structure validation from creation through review.