diff --git a/.ai/skills/analysis/SKILL.md b/.ai/skills/analysis/SKILL.md index 7626c70..96e7569 100644 --- a/.ai/skills/analysis/SKILL.md +++ b/.ai/skills/analysis/SKILL.md @@ -1,6 +1,8 @@ --- name: analysis description: Analyze user requests, evaluate requirements, and propose AI action plans. Use when analyzing code, errors, or planning tasks. +category: workflow +impact: high --- # Analysis Instructions diff --git a/.ai/skills/clean-architecture/SKILL.md b/.ai/skills/clean-architecture/SKILL.md index 43ac547..f064199 100644 --- a/.ai/skills/clean-architecture/SKILL.md +++ b/.ai/skills/clean-architecture/SKILL.md @@ -1,6 +1,8 @@ --- name: clean-architecture description: Enforce clean architecture principles and Hexagonal/Onion patterns. Use when designing system architecture, domains, or defining module boundaries. +category: code +impact: medium --- # Clean Architecture diff --git a/.ai/skills/clean-code/SKILL.md b/.ai/skills/clean-code/SKILL.md index 78ebbd0..0552183 100644 --- a/.ai/skills/clean-code/SKILL.md +++ b/.ai/skills/clean-code/SKILL.md @@ -1,6 +1,8 @@ --- name: clean-code description: Apply clean code principles, SOLID, and DRY practices. Use when writing, reviewing, or refactoring application code. +category: code +impact: medium --- # Clean Code Guidelines diff --git a/.ai/skills/core-principles/SKILL.md b/.ai/skills/core-principles/SKILL.md index a0a97c0..e24a8ef 100644 --- a/.ai/skills/core-principles/SKILL.md +++ b/.ai/skills/core-principles/SKILL.md @@ -2,6 +2,7 @@ name: core-principles description: The absolute foundational behavior, etiquette, and operational methodology for the AI assistant. Use when discussing AI behavior, rules, speed vs quality, or making decisions. category: meta +impact: high --- > **🏷️ Category:** `Meta-Skill` | **⚙️ Applies to:** AI Behavior, Ethics & Operational Methodology diff --git a/.ai/skills/docs/SKILL.md b/.ai/skills/docs/SKILL.md index b3d15a0..beea0fb 100644 --- a/.ai/skills/docs/SKILL.md +++ b/.ai/skills/docs/SKILL.md @@ -1,7 +1,8 @@ --- name: docs description: Rules for maintaining the project's documentation folder (ai-context.md and architecture.md). Use when editing or creating project documentation files. -category: meta +category: workflow +impact: low --- > **🏷️ Category:** `Meta-Skill` | **⚙️ Applies to:** Project Documentation Management diff --git a/.ai/skills/documentation/SKILL.md b/.ai/skills/documentation/SKILL.md index 9eb7349..18bdabe 100644 --- a/.ai/skills/documentation/SKILL.md +++ b/.ai/skills/documentation/SKILL.md @@ -1,6 +1,8 @@ --- name: documentation description: Rules and structures for writing project documentation in Markdown. Use when creating, formatting, or updating markdown docs. +category: workflow +impact: low --- # Documentation Instructions diff --git a/.ai/skills/file-editing/SKILL.md b/.ai/skills/file-editing/SKILL.md index 18936b0..75c1f17 100644 --- a/.ai/skills/file-editing/SKILL.md +++ b/.ai/skills/file-editing/SKILL.md @@ -1,6 +1,8 @@ --- name: file-editing description: Rules for sandbox file editing into tmp/ topics to avoid root pollution. Use when creating temporary files, drafts, scratchpads, or experimenting. +category: workflow +impact: low --- # File Editing Instructions diff --git a/.ai/skills/git/SKILL.md b/.ai/skills/git/SKILL.md index 706f01c..e475d5f 100644 --- a/.ai/skills/git/SKILL.md +++ b/.ai/skills/git/SKILL.md @@ -1,6 +1,8 @@ --- name: git description: Enforce semantic versioning and strict Git commit message formats (topic-level). Use when committing code, parsing git history, or writing commit messages. +category: workflow +impact: medium --- # Git Instructions diff --git a/.ai/skills/grill-me/SKILL.md b/.ai/skills/grill-me/SKILL.md index 14b8b1d..cc3aa53 100644 --- a/.ai/skills/grill-me/SKILL.md +++ b/.ai/skills/grill-me/SKILL.md @@ -1,6 +1,8 @@ --- name: grill-me description: Active interrogator mode to clarify fuzzy requirements before starting work. Use when the user asks to be grilled, questioned, or needs to flesh out an idea. +category: workflow +impact: medium --- # Grill Me Instructions diff --git a/.ai/skills/helm/SKILL.md b/.ai/skills/helm/SKILL.md index 1330cda..302ac7d 100644 --- a/.ai/skills/helm/SKILL.md +++ b/.ai/skills/helm/SKILL.md @@ -1,6 +1,8 @@ --- name: helm description: Helm chart guidelines focusing on explicit resource naming over complex umbrellas. Use when creating, modifying, or reviewing Helm charts and Kubernetes manifests. +category: infra +impact: medium --- # Helm Chart Development Guidelines diff --git a/.ai/skills/iac/SKILL.md b/.ai/skills/iac/SKILL.md index b9e3af1..d69e5f6 100644 --- a/.ai/skills/iac/SKILL.md +++ b/.ai/skills/iac/SKILL.md @@ -1,6 +1,8 @@ --- name: iac description: Best practices for Infrastructure as Code, GitOps, minimizing configuration drift, and avoiding imperative infrastructure operations. +category: infra +impact: high --- # Infrastructure as Code (IaC) diff --git a/.ai/skills/kubernetes-access/SKILL.md b/.ai/skills/kubernetes-access/SKILL.md index b3a9cb8..2224621 100644 --- a/.ai/skills/kubernetes-access/SKILL.md +++ b/.ai/skills/kubernetes-access/SKILL.md @@ -1,6 +1,8 @@ --- name: kubernetes-access description: Defines workflows for interacting with Kubernetes clusters, depending on whether a valid kubeconfig is present. Emphasizes read-only access and strict IaC adherence. +category: infra +impact: high --- # Kubernetes & Helm Access diff --git a/.ai/skills/mermaid/SKILL.md b/.ai/skills/mermaid/SKILL.md index e09b1a9..3501919 100644 --- a/.ai/skills/mermaid/SKILL.md +++ b/.ai/skills/mermaid/SKILL.md @@ -1,6 +1,8 @@ --- name: mermaid description: Safe Mermaid diagram generation avoiding raw HTML entities and newlines. Use when generating, formatting, or updating Mermaid graphs or diagrams. +category: workflow +impact: low --- # Mermaid Diagram Instructions diff --git a/.ai/skills/project-context/SKILL.md b/.ai/skills/project-context/SKILL.md index 232b9f0..bb84742 100644 --- a/.ai/skills/project-context/SKILL.md +++ b/.ai/skills/project-context/SKILL.md @@ -2,6 +2,7 @@ name: project-context description: Establish how the AI should fetch, create, and interact with a project's individual ai-context.md file. Use when setting up a new project or looking for project repo context. category: meta +impact: low --- > **🏷️ Category:** `Meta-Skill` | **⚙️ Applies to:** AI Internal Operations & Context Discovery diff --git a/.ai/skills/readme/SKILL.md b/.ai/skills/readme/SKILL.md index 884e55b..9ad8363 100644 --- a/.ai/skills/readme/SKILL.md +++ b/.ai/skills/readme/SKILL.md @@ -2,6 +2,7 @@ name: readme description: Guidelines for creating or updating README files. Use when generating, formatting, or editing the project's root README.md. category: meta +impact: low --- > **🏷️ Category:** `Meta-Skill` | **⚙️ Applies to:** Project Documentation Management diff --git a/.ai/skills/root-skill/SKILL.md b/.ai/skills/root-skill/SKILL.md index 462b367..b652c3c 100644 --- a/.ai/skills/root-skill/SKILL.md +++ b/.ai/skills/root-skill/SKILL.md @@ -2,6 +2,7 @@ name: root-skill description: The absolute master configuration and state machine for the AI. This is the entry point that governs how the AI operates, changes states, and loads other skills. category: meta +impact: high --- > **🏷️ Category:** `Meta-Skill` | **⚙️ Applies to:** Global AI State Machine & Workflow diff --git a/.ai/skills/use-cases/SKILL.md b/.ai/skills/use-cases/SKILL.md index 6c66027..fe7638d 100644 --- a/.ai/skills/use-cases/SKILL.md +++ b/.ai/skills/use-cases/SKILL.md @@ -1,6 +1,8 @@ --- name: use-cases description: Structure use case documentation following rigid outlines to prevent bloat. Use when defining application use cases, stories, or functional requirements. +category: workflow +impact: low --- # Use Cases Instructions diff --git a/.ai/skills/write-skill/SKILL.md b/.ai/skills/write-skill/SKILL.md index 1c86cb2..ecbc053 100644 --- a/.ai/skills/write-skill/SKILL.md +++ b/.ai/skills/write-skill/SKILL.md @@ -1,7 +1,8 @@ --- name: write-skill description: Create new agent skills with proper structure and AI superpower constraints. Use when user wants to create, write, or build a new skill, rule, or instruction. -category: meta +category: workflow +impact: medium --- > **🏷️ Category:** `Meta-Skill` | **⚙️ Applies to:** AI Internal Operations & Context Discovery @@ -15,7 +16,7 @@ Force the AI to structure all new knowledge files into the strict, restrictive, ## 🚨 Prohibitions (Thou Shalt Not) -- **NEVER create a new skill without YAML frontmatter.** It MUST contain `name` and `description` (with "Use when [triggers]"). +- **NEVER create a new skill without YAML frontmatter.** It MUST contain `name`, `categoy`, `impact` and `description` (with "Use when [triggers]"). - **NEVER create a skill longer than 100 lines.** If it's too long, split the theory/examples into `REFERENCE.md` or `EXAMPLES.md`. - **NEVER write text-heavy prose.** Use bullet points, bold text, and "Negative Prompting" (`🚨 Prohibitions: NEVER...`). - **NEVER skip the `ai-root-instructions.md` integration.** The skill does not exist until it's registered in the router. @@ -31,13 +32,20 @@ Force the AI to structure all new knowledge files into the strict, restrictive, - Run `create_file` to save `SKILL.md`. - Run `replace_string_in_file` to add a new trigger line to `.ai/skills/ai-root-instructions/SKILL.md`. +## Impact Selection Criteria: +- high: Foundational rules. Security, state machines (root-skill), core ethics, or infrastructure integrity (IaC). If this rule is broken, the project or AI logic fails. +- medium: Workflow & Quality. Coding standards, Git practices, architectural patterns. Important for long-term health, but doesn't crash the system immediately. +- low: Formatting & Tools. Mermaid syntax, README structures, or temporary file handling. Purely aesthetic or helper-level instructions. + ## ✅ / ❌ Examples ### The Mandatory SKILL.md Template ```md --- -name: [skill-name] -description: [1st sentence: what it does. 2nd sentence: "Use when [specific triggers]."] +name: +description: +category: +impact: --- # [Skill Name]