ai-guidelines

Centralize AI guidelines and skill definitions under .ai/ for synchronized generation.

214|2|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/SanderMuller/laravel-fluent-validation --skill ai-guidelines
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ai-guidelines
Source: https://github.com/SanderMuller/laravel-fluent-validation/tree/main/.ai/skills/ai-guidelines
Command: npx skills add https://github.com/SanderMuller/laravel-fluent-validation --skill ai-guidelines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

AI project guidelines and skill definitions are often scattered, inconsistently updated, and out of sync with generated contexts. ai-guidelines provides a centralized, version-controlled source of truth for AI guidelines and skill definitions, ensuring consistent behavior across CLAUDE.md, AGENTS.md, and related outputs.

Core Features & Use Cases

  • Centralized source of truth: Guidelines in .ai/guidelines and skills in .ai/skills, ensuring consistency.
  • Auto-generation & sync: After edits run the package-boost:sync to update CLAUDE.md, AGENTS.md, and generated skill files under .claude/skills/ and .github/skills/.
  • Safe editing workflow: Edit only in .ai/; generated files are overwritten to reflect source changes.
  • Activation triggers & governance: Clearly defined triggers to activate or modify AI skills and guidelines.

Quick Start

Edit the AI guidelines and skill definitions under .ai/, then run vendor/bin/testbench package-boost:sync to propagate changes to generated files.

Frequently Asked Questions about ai-guidelines

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

FAQPage Schema
How do I keep AI guidelines and skill definitions consistent across CLAUDE.md and AGENTS.md?

To keep AI guidelines consistent across CLAUDE.md and AGENTS.md, centralize your source definitions in the .ai/ directory and run a sync command to automatically propagate updates to all generated output files.

What is the safe editing workflow for AI project guidelines to prevent configuration drift?

The safe editing workflow for AI project guidelines requires editing source files only within the .ai/ directory. Generated files like CLAUDE.md are safely overwritten during sync to prevent configuration drift.

How to generate AI skill files from markdown without adding external dependencies?

You generate AI skill files by editing markdown content in the .ai/skills directory and running the sync command. The generation process is dependency-free and overwrites existing files to reflect source changes.

Does the ai-guidelines skill require external dependencies to manage AI governance?

No, managing AI governance with this skill requires zero external dependencies. It safely generates outputs and propagates metadata structures using a frontmatter-driven approach within your existing project.

What happens if I manually edit generated AI context files like CLAUDE.md?

If you manually edit generated AI context files like CLAUDE.md, your changes will be overwritten. You must edit only the source files in the .ai/ directory and run the sync command to propagate updates safely.