What is skillsaw AGENTS.md?

Project instructions for Skillsaw, a rule-based linter that checks instructions and other context used by coding agents.

Use them when developing Skillsaw, running its test and lint checks, updating generated files, reviewing documentation, or testing it against another project.

They define the checks required before pushing or opening a pull request, reducing the chance that tests, formatting, generated files, or documentation are missed.

skillsaw AGENTS.md — Instructions file for Codex and OpenCode by stbenjam: Project instructions for Skillsaw, a rule-based linter that check

Install

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.

agentmods

npx agentmods add instructions/stbenjam/skillsaw/agents-md

Clone the repo

git clone --depth 1 https://github.com/stbenjam/skillsaw

Made for: Codex, OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/stbenjam/skillsaw/agents-md.svg)](https://agentmods.dev/instructions/stbenjam/skillsaw/agents-md)

Your own site

<a href="https://agentmods.dev/instructions/stbenjam/skillsaw/agents-md"><img src="https://agentmods.dev/badge/instructions/stbenjam/skillsaw/agents-md.svg" alt="Measured on agentmods" height="20"></a>

Per session 4,588 This file is loaded in full into every session.

When invoked 4,588 The same file — it is already loaded in full.

Security scan A 1 finding. Scan, not verified.

Origin 98% copy Near-identical to another mod in the catalogue.

Token cost

What 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.04588	$0.04588
Opus 5	$0.02294	$0.02294
Sonnet 5	$0.00918	$0.00918
Haiku 4.5	$0.00459	$0.00459

Measured 4d ago against content hash 85a51a12ff2a, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

skillsaw AGENTS.md scanned grade A with 1 finding 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 4d ago.

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.

Runs shell commandslowCapability

Expected in a hook, worth knowing in a rule or an instructions file.

`subprocess.CompletedProcess` stand-in. Spawning an interpreter per call cost

Origin

This is a copy

98% identical to skillsaw copilot-instructions.md — 12 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

AGENTS.md · 342 lines

How it starts

The opening of the file, as written. The whole thing — 342 lines — stays where its author put it; the contents beside it link to each section on GitHub.

AGENTS.md

Global Instructions

Follow these rules when developing skillsaw, a configurable, rule-based linter for agentic contextual building blocks.

Pre-push Checklist

CRITICAL: You MUST always run these steps before pushing changes.

Ensure branch is up to date with UPSTREAM (stbenjam/skillsaw) — check git remotes then merge upstream's main.
Run make test — run the full test suite and ensure all tests pass. Never assume a problem is pre-existing; follow the boyscout rule and fix it anyway.
Run make lint — check formatting (or run make format to fix it).
Run make update — regenerate all generated files (must come after version bump).
Test against openshift-eng/ai-helpers: clone it, run skillsaw, and ensure exit 0.

Pre-PR Checklist

Follow these checks before opening a PR:

Check whether documentation is up to date for the changes on this branch.
- Example: you add a new feature, flag, or lint type. Action: update README.md to include this.
- Example: you encounter a problem during development you must keep for later. Action: update .apm/instructions and run make update.
Verify test coverage on a new feature, flag, lint type or bug fix is complete.
- Bug fixes must include regression protection.
- New features, linters, and rules need integration test coverage WITH fixtures (see testing rules).

Authoring Agentic Context

When you create or edit a skill, slash command, agent, hook, or instruction file in this repo, load the skillsaw-lint skill and follow it: lint the file with .venv/bin/skillsaw lint <path>, apply fixes, and re-lint until clean before you finish. We ship the linter — our own context must pass it.

Post-PR Checklist

After opening a PR, keep monitoring for feedback from CodeRabbit, Gemini, and stbenjam. You may stop monitoring 20 minutes after you push a PR. Review and handle valid feedback that comes in.

Read the full file on GitHub · 342 lines

Changes

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.

4d ago First seen · 342 lines · 4,588 tokens per session scan A 85a51a12ff2a

Subscribe to this mod's changes

skillsaw AGENTS.md is an instructions file published in the GitHub repository stbenjam/skillsaw (59 stars, last pushed 4d ago), licensed Apache-2.0. It adds 4,588 tokens to every session, about $0.0229 per session on Opus 5. A static security scan graded it A with 1 finding (runs shell commands). It is 98% identical to skillsaw copilot-instructions.md, differing in 12 lines, and is treated as a copy.

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 6,785 tokens

skillsaw AGENTS.md