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 skills add drmahdikazempour/agent-stack --skill stack-doctorgit clone --depth 1 https://github.com/drmahdikazempour/agent-stackWrote 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.
[](https://agentmods.dev/skills/drmahdikazempour/agent-stack/stack-doctor)<a href="https://agentmods.dev/skills/drmahdikazempour/agent-stack/stack-doctor"><img src="https://agentmods.dev/badge/skills/drmahdikazempour/agent-stack/stack-doctor/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/drmahdikazempour/agent-stack/stack-doctor"><img src="https://agentmods.dev/badge/skills/drmahdikazempour/agent-stack/stack-doctor.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.1 | $0.00088 | $0.00342 |
| Opus 5.5 | $0.00035 | $0.00137 |
| Sonnet 5.5 | $0.00018 | $0.00068 |
| Haiku 4.5 | $0.00009 | $0.00034 |
Grade A, and why
stack-doctor 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 1mo 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.
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.
What it actually says
stack-doctor
Lint the optimization layer and report problems with exact files and limits.
Checks performed
CLAUDE.md≤ 800 tokens (startup-load budget).- Each
SKILL.mddescription ≤ 1024 chars (Agent Skills hard limit). - Each
SKILL.mdbody ≤ 500 lines. - Combined skill metadata ≤ 500 tokens.
- Zero hook conflicts in
.claude/settings.json. - Valid frontmatter (
name+description) on every skill. - Every adapter binary callable, or clearly flagged as config-only.
What to do
- Run
npx @drmahdikazempour/agent-stack doctor. - If it exits non-zero, surface each failure with the file and the limit it broke.
- For auto-fixable issues (e.g. CLAUDE.md over budget), offer
npx @drmahdikazempour/agent-stack optimize. - For hook conflicts, never hand-edit
settings.json— re-runinit/profile useso the merger reconciles them.
--skills-only lints just the SKILL.md files (used in CI).
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.
- 1mo ago First seen · 26 lines · 88 tokens per session scan A 2a7c7f443a1d
stack-doctor is a skill published in the GitHub repository drmahdikazempour/agent-stack (3 stars, last pushed 4mo ago), licensed MIT. It adds 88 tokens to every session and 342 once invoked, about $0.0004 per session on Opus 5.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-31.
Other skills, from other repositories
sxo
Search Experience Optimization (SXO), the bridge between SEO and UX/CRO. Audits the journey from the SERP click to the on-page goal: click-through factors (title, meta, rich results), then post-click signals that keep users and drive conversions: above-the-fold relevance and intent match, page speed / Core Web Vitals…
meta-tags-optimizer
Optimize title tags, meta descriptions, Open Graph, and Twitter cards for maximum click-through rate. Generates multiple A/B test variations with character counting and SERP preview. Use when asked to "optimize title tag", "write meta description", "improve CTR", "Open Graph tags", "fix my meta tags", "social media…
chief-strategy-officer
Owns where the business plays and how it wins over a multi-year horizon — portfolio choices, corporate development, strategic partnerships, and planning under uncertainty. Use this for a decision about which markets or businesses to be in, whether to build, buy, or partner, how to allocate capital across business…
chief-revenue-officer
Owns the revenue engine end to end: sales, monetization, pricing, customer success, retention, and partnerships. Use this for pricing and packaging decisions, sales strategy and coverage, forecast and pipeline health, churn and expansion, partner and channel strategy, or when marketing-sourced demand is not…
paid-advertising
Plans, runs, and optimizes paid acquisition across search, social, and display — account structure, targeting, creative, bidding, budget, and the analysis that says whether to scale or stop. Use this to set up or restructure campaigns, write and iterate ad creative, diagnose rising costs or falling performance, decide…
vendor-management
Selects, contracts, and manages suppliers and vendors — requirements, evaluation, negotiation support, onboarding, performance management, and exit. Use this to choose a vendor, run a selection process, structure a service agreement's operational terms, manage an underperforming supplier, plan an exit or migration, or…