Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add instructions/ydeng11/rulesify/agents-mdgit clone --depth 1 https://github.com/ydeng11/rulesifyWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.04210 | $0.04210 |
| Opus 5 | $0.02105 | $0.02105 |
| Sonnet 5 | $0.00842 | $0.00842 |
| Haiku 4.5 | $0.00421 | $0.00421 |
Grade A, and why
rulesify AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 456 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AGENTS.md - Rulesify Project Guide
Quick reference for AI agents working on this Rust CLI project.
Tech Stack
Core
- Rust 1.94+ (Edition 2021)
- Cargo - Build system and package manager
Dependencies
| Package | Version | Purpose |
|---|---|---|
clap |
4.5 | CLI argument parsing (derive macros) |
tokio |
1.37 | Async runtime (rt-multi-thread, macros) |
reqwest |
0.12 | HTTP client for GitHub API (json feature) |
serde |
1.0 | Serialization (derive) |
serde_yaml |
0.9 | YAML parsing for SKILL.md frontmatter |
serde_json |
1.0 | JSON for API response cache |
toml |
0.8 | TOML parsing for config and registry |
ratatui |
0.26 | Terminal UI framework |
crossterm |
0.27 | Cross-platform terminal control |
chrono |
0.4 | Date/time with serde support |
anyhow |
1.0 | Application error handling |
thiserror |
1.0 | Custom error types |
dirs |
5.0 | System directory paths |
walkdir |
2.4 | Recursive directory traversal |
env_logger |
0.10 | Logging implementation |
log |
0.4 | Logging facade |
Dev Dependencies
tempfile3.8 - Temporary files for tests
Project Structure
rulesify/
├── Cargo.toml # Dependencies and metadata
├── registry.toml # Skills catalog (generated by update-registry)
├── src/
│ ├── main.rs # Entry point (tokio runtime, CLI dispatch)
│ ├── lib.rs # Library exports
│ ├── bin/
│ │ └── update-registry.rs # Registry automation binary
│ ├── cli/
│ │ ├── mod.rs # CLI structure (clap Parser/Subcommand)
│ │ ├── init.rs # Main TUI interface (default command)
│ │ └── skill.rs # `rulesify skill list/add/remove/update`
│ ├── models/
│ │ ├── mod.rs # Model exports
│ │ ├── skill.rs # Skill struct (name, description, stars, install_action)
│ │ ├── registry.rs # Registry struct (HashMap of skills)
│ │ ├── skill_metadata.rs # Raw skill data from GitHub
│ │ ├── install_action.rs # Install types (copy/command)
│ │ ├── context.rs # ProjectContext (languages, frameworks, tools)
│ │ ├── config.rs # ProjectConfig (installed skills tracking)
│ │ ├── global_config.rs # GlobalConfig (per-tool global skills tracking)
│ │ └── *_tests.rs # Unit tests
│ ├── registry/
│ │ ├── mod.rs # Registry module exports
│ │ ├── data.rs # Built-in registry loader (include_str!)
│ │ ├── fetch.rs # Remote registry fetcher
│ │ ├── cache.rs # Local cache management
│ │ ├── source.rs # SourceRepo enum (GitHub repos)
│ │ ├── github.rs # GitHub API v3 client
│ │ ├── parser.rs # SKILL.md frontmatter parser
│ │ ├── scorer.rs # Quality scoring (stars-based)
│ │ ├── generator.rs # TOML registry generator
│ │ └── *_tests.rs # Unit tests
│ ├── scanner/
│ │ ├── mod.rs # Scanner orchestration
│ │ ├── language.rs # Language detection (file extensions + configs)
│ │ ├── framework.rs # Framework detection (package files)
│ │ ├── tool_config.rs # AI tool config detection (.cursor, CLAUDE.md)
│ │ └ *_tests.rs # Unit tests
│ ├── tui/
│ │ ├── mod.rs # TUI module exports
│ │ ├── tool_picker.rs # Interactive tool selection (ratatui)
│ │ └ skill_selector.rs # Interactive skill selection (ratatui)
│ ├── installer/
│ │ ├── mod.rs # Installer module exports
│ │ ├── instructions.rs # Install/uninstall instruction generator
│ │ ├── tool_paths.rs # Tool-specific skill path mapping
│ │ └ *_tests.rs # Unit tests
│ └ utils/
│ ├── mod.rs # Utils exports
│ └ error.rs # Error types (RulesifyError enum)
│ └ *_tests.rs # Unit tests
├── .github/
│ └── workflows/
│ └── update-registry.yml # Weekly registry automation
├── .planning/ # GSD project management files
│ ├── STATE.md # Current project state
│ ├── ROADMAP.md # Phase breakdown
│ ├── PROJECT.md # Project description
│ └ REQUIREMENTS.md # Requirements list
│ └ codebase/ # Codebase documentation
│ └ research/ # Research artifacts
├── docs/
│ └ plans/ # Execution plans and summaries
└── target/ # Build output (release/debug)
rulesify/
├── Cargo.toml # Dependencies and metadata
├── registry.toml # Built-in skill registry (compiled into binary)
├── src/
│ ├── main.rs # Entry point (tokio runtime, CLI dispatch)
│ ├── lib.rs # Library exports
│ ├── cli/
│ │ ├── mod.rs # CLI structure (clap Parser/Subcommand)
│ │ ├── init.rs # Main TUI interface (default command)
│ │ └── skill.rs # rulesify skill list/add/remove/update
│ ├── models/
│ │ ├── mod.rs # Model exports
│ │ ├── skill.rs # Skill struct (name, description, tags, tools)
│ │ ├── registry.rs # Registry struct (HashMap of skills)
│ │ ├── context.rs # ProjectContext (languages, frameworks, tools)
│ │ ├── config.rs # ProjectConfig (installed skills tracking)
│ │ ├── global_config.rs # GlobalConfig (per-tool global skills tracking)
│ │ └── *_tests.rs # Unit tests
│ ├── registry/
│ │ ├── mod.rs # Registry module exports
│ │ ├── data.rs # Built-in registry loader (include_str!)
│ │ ├── fetch.rs # GitHub registry fetcher (async)
│ │ ├── cache.rs # Local cache management
│ │ └ *_tests.rs # Unit tests
│ ├── scanner/
│ │ ├── mod.rs # Scanner orchestration
│ │ ├── language.rs # Language detection (file extensions + configs)
│ │ ├── framework.rs # Framework detection (package files)
│ │ ├── tool_config.rs # AI tool config detection (.cursor, CLAUDE.md)
│ │ └ *_tests.rs # Unit tests
│ ├── tui/
│ │ ├── mod.rs # TUI module exports
│ │ ├── tool_picker.rs # Interactive tool selection (ratatui)
│ │ └ skill_selector.rs # Interactive skill selection (ratatui)
│ ├── installer/
│ │ ├── mod.rs # Installer module exports
│ │ └ instructions.rs # Installation instruction generator
│ └ utils/
│ ├── mod.rs # Utils exports
│ └ error.rs # Error types (RulesifyError enum)
├── .planning/ # GSD project management files
│ ├── STATE.md # Current project state
│ ├── ROADMAP.md # Phase breakdown
│ ├── PROJECT.md # Project description
│ └ REQUIREMENTS.md # Requirements list
│ └ codebase/ # Codebase documentation
│ └ research/ # Research artifacts
├── docs/
│ └ plans/ # Execution plans and summaries
└── target/ # Build output (release/debug)
---
## Common Commands
### Build & Run
```bash
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- yesterday First seen · 456 lines · 4,210 tokens per session scan A b908e6fe4201
rulesify AGENTS.md is an instructions file published in the GitHub repository ydeng11/rulesify (19 stars, last pushed 2d ago), licensed MIT. It adds 4,210 tokens to every session, about $0.0210 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other instructions, from other repositories
actionbook CLAUDE.md
Instructions for actionbook/actionbook, covering claude.md, project overview, architecture, domain model hierarchy and module structure.
cartog AGENTS.md
Instructions for jrollin/cartog, covering agent guidelines, project, build & test, integrity checks and code conventions.
topos CLAUDE.md
Instructions for topos-sh/topos, covering map — read the claude.md in the folder you're working in, build / test / lint, the crate graph (acyclic), principles that constrain this code and conventions.
skilly AGENTS.md
AGENTS.md instructions for xelandernt/skilly, covering agents.md, 1. think before coding, 2. simplicity first, 3. surgical changes and 4. goal-driven execution.
skills AGENTS.md
AGENTS.md instructions for PsiACE/skills, covering navigation notes and conventions.
skill-zoo AGENTS.md
Instructions for luochang212/skill-zoo, covering agents.md, how we work, what this project is, project layout and core design decisions.