Rule Creator

Create and format agent rules with proper front matter in the workspace

bazelbuild Updated

File contents

Use this skill when you need to create a new rule for the agent in the workspace.

Rule File Location

All workspace-specific rules must be created as individual Markdown files under the .agents/rules/ directory:

.agents/rules/<rule-name>.md

Rule Format

Every rule file must start with a YAML front matter block defining the trigger condition, followed by the rule content in Markdown.

---
trigger: <trigger-condition>
---

# <Rule Title>

<Rule description and directives...>
Trigger Conditions
  • always_on: The rule is always active and must be followed for all tasks.
  • Custom triggers: You can specify other trigger conditions if the rule only applies in certain contexts.

Formatting Guidelines

  • Line Wrapping: Always wrap all text in the rule file (including the title and description) to 80 columns to ensure readability and compatibility.
  • Clarity: Write clear, actionable directives.

Example

To create a rule that prevents adding copyrights:

---
trigger: always_on
---

# No Copyrights Rule

Unless directed by the user otherwise, do not add Bazel copyright to new or
existing files.

bazelbuild/rules_python/tree/main/.agents/skills/rule-creator commit 9ed7978120

Frequently asked questions

npx skillmds@latest add bazelbuild/rule-creator