rules-normalize

Normalize project conventions into governed GAAI rule files.

1|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/bketelsen/truenas-mcp --skill rules-normalize
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rules-normalize
Source: https://github.com/bketelsen/truenas-mcp/tree/main/.gaai/core/skills/cross/rules-normalize
Command: npx skills add https://github.com/bketelsen/truenas-mcp --skill rules-normalize

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill transforms scattered or implicit project conventions (like linter settings or style guides) into explicit, machine-readable governance rules, ensuring consistency and integrity across the project.

Core Features & Use Cases

  • Convention Normalization: Converts existing project standards into formal GAAI rule files.
  • Rule Integrity: Ensures new or modified rule files adhere to a standard format and do not conflict with existing rules.
  • Use Case: During project bootstrapping, use this Skill to analyze existing CI configurations and code style guides, then generate a set of .rules.md files that formally document these conventions for AI agents to follow.

Quick Start

Use the rules-normalize skill to convert existing project conventions into governed GAAI rule files.

Frequently Asked Questions about rules-normalize

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

FAQPage Schema
How do I convert project conventions into machine-readable rules?

To convert project conventions into machine-readable rules, use a normalization process that transforms scattered standards like linter settings into formal rule files. This ensures consistency by requiring explicit condition, scope, and enforcement level definitions for each generated rule.

What is convention normalization for AI agent governance?

Convention normalization for AI agent governance is the process of transforming implicit project standards into explicit, machine-readable rule files. It ensures AI agents follow established project conventions by formally documenting settings and style guides with defined enforcement levels.

How do I bootstrap governance rules from existing CI configurations?

To bootstrap governance rules from existing CI configurations, analyze your current configurations and code style guides, then generate formal `.rules.md` files. This process normalizes scattered standards into governed rule files for AI agents to follow.

Can I ensure rule integrity when modifying existing project conventions?

You can ensure rule integrity when modifying existing project conventions by requiring explicit condition, scope, and enforcement level definitions. This normalization process guarantees that new or modified rule files adhere to a standard format and do not conflict with existing rules.

Does convention normalization require explicit enforcement level definitions?

Yes, convention normalization requires explicit enforcement level definitions for each rule, along with defined conditions and scopes. This strict requirement ensures rule integrity and prevents conflicts when creating or modifying governed rule files.

When do I need to normalize scattered project standards into rule files?

You need to normalize scattered project standards into rule files during project bootstrapping, when creating new rules, or when modifying existing rules. This process converts implicit conventions into governed rule files, ensuring consistency and integrity across the project.