Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →waybarrios/agents-md-improver
Audit and improve project-rules files (AGENTS.md, CLAUDE.md, .agents/instructions, local overrides) so the agent keeps accurate project context.
Passed 12 of 17 test cases with the skill, and 9 of 17 without it.
and 5 more in the full report
7 fixed9 passed either way4 still failing2 broke
Tokens, turns and time describe resource use, not a dollar price.
One of 7 test cases the skill fixed. Same model, same prompt, with and without the skill.
When evaluating an instructions file that provides basic overview information but lacks key deployment scripts and non-obvious gotchas, resulting in a score of 65 out of 100, what letter grade corresponds to this evaluation level?
| Checked | Without skill | With skill |
|---|---|---|
| Assigns a letter grade of C for a quality score of 65 based on the standard assessment scale. | Missed | Passed |
The instructions your model reads when the skill loads.
Audit, evaluate, and improve project-rules files across a codebase to ensure the agent has optimal project context.
Read references/project-rule-resolution.md, resolved relative to this loaded SKILL.md directory and not the consuming project's CWD or working directory, before discovery or resolution analysis. Apply only the behavior for the target client and pinned version; do not collapse OpenCode startup, OpenCode lazy nested, and Claude Code resolution into one rule.
This skill can write to project-rules files. After presenting a quality report and getting user approval, it updates the files with targeted improvements.
[REDACTED] and retain only the minimum location, type, and remediation evidence.Read the matrix before discovery. Use the environment's native file search or glob tool when available; otherwise recursively enumerate the full relevant tree without silent result caps. Do not use a truncated pipeline that can hide rules files.
Inventory only accessible and relevant sources supported by the matrix:
AGENTS.md, CLAUDE.md, deprecated CONTEXT.md, CLAUDE.local.md, .claude/CLAUDE.md, and .claude/rules/**/*.md files.CLAUDE.md and CLAUDE.local.md files that can load lazily, plus all .claude/rules/**/*.md files, including unconditional rules and paths-conditional rules discovered recursively regardless of directory nesting.@ imports relative to each containing file. Track canonical visited paths for cycle detection, stop at the verified maximum of four import hops, and, before reading an import outside the project, obtain explicit user approval.instructions paths or globs..agents.local.md and .claude.local.md are unsupported; CLAUDE.local.md is Claude-native but not OpenCode-native.File types and locations:
| Type | Location | Purpose |
|---|---|---|
| Project root (OpenCode native) | ./AGENTS.md | Primary project context (committed, shared) |
| Project root (portable bridge) | ./CLAUDE.md containing @AGENTS.md | Makes canonical AGENTS.md available to Claude |
| Claude project/local | .claude/CLAUDE.md, CLAUDE.local.md | Claude-native project or personal context |
| Claude project rules | .claude/rules/**/*.md | Unconditional or paths-conditional rules discovered recursively |
| OpenCode global | ~/.config/opencode/AGENTS.md | User-wide OpenCode context |
test cases passed, vs 9 / 17 without
Published skills whose descriptions closely match this one, with their headline benchmark lift.
More skills from the same source and nearby in the registry, with their headline benchmark lift.