Awesome-omni-skill fetch-rules

Fetch and apply Cursor-style workspace rules supporting all rule formats (.cursor/rules/*.md, *.mdc, AGENTS.md, and legacy .cursorrules).

install
source · Clone the upstream repo
git clone https://github.com/diegosouzapw/awesome-omni-skill
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/backend/fetch-rules" ~/.claude/skills/diegosouzapw-awesome-omni-skill-fetch-rules && rm -rf "$T"
manifest: skills/backend/fetch-rules/SKILL.md
source content

Fetch Rules

Purpose

This skill emulates Cursor's rule selection behavior for AI agents.

It discovers and selects rules from:

  • Project Rules (
    .cursor/rules/
    )
    • .mdc
      files with frontmatter (
      description
      ,
      globs
      ,
      alwaysApply
      )
    • .md
      files without frontmatter (treated as always-apply)
  • AGENTS.md files (root and nested subdirectories)
  • Legacy
    .cursorrules
    at repo root (deprecated but still supported)

Rule Selection Semantics

Rule TypeSelection Behavior
alwaysApply: true
Always included
Simple
.md
(no frontmatter)
Always included
globs: ...
Included when any candidate file matches
description: ...
Included when prompt overlaps with description keywords
No metadata (
.mdc
only)
Included only when explicitly referenced
AGENTS.md
Always included when in scope (directory hierarchy)

Candidate files come from

--files
,
--use-git-diff
, and file-like paths found in
--prompt
.

Requirements

  • bash
    (macOS / Linux default)
  • git
    optional (only if you use
    --use-git-diff
    )

No Python, Node, or jq required.

Usage

Run commands from this skill directory (the directory containing this

SKILL.md
). Do not hardcode agent install paths.

bash scripts/fetch_rules.sh --prompt "<your request>"

Optional file hints:

bash scripts/fetch_rules.sh --prompt "<request>" --files path/to/a.ts path/to/b.sql
bash scripts/fetch_rules.sh --prompt "<request>" --use-git-diff

Force-include a rule by filename:

bash scripts/fetch_rules.sh --prompt "<request>" --explicit global.mdc
bash scripts/fetch_rules.sh --prompt "<request>" --explicit react-patterns.md

Supported Formats

FormatLocationDescription
.mdc
.cursor/rules/
Rules with YAML frontmatter for fine-grained control
.md
.cursor/rules/
Simple markdown rules (always applied)
AGENTS.md
Root or subdirsSimple agent instructions (always applied in scope)
.cursorrules
Root onlyLegacy format (deprecated, will be removed)

Notes

  • If multiple rules share the same filename, the rule in the closest scoped directory wins (deepest scope).
  • Glob matching uses bash pattern matching (
    [[ file == pattern ]]
    ). Cursor-style
    **
    works effectively as
    *
    in this matcher.
  • AGENTS.md
    files are combined hierarchically—parent directories' instructions apply alongside more specific subdirectory instructions.