# Stack Doctor

> Lint the agent-stack setup — CLAUDE.md token budget (≤800), each SKILL.md description (≤1024 chars) and body (≤500 lines), hook conflicts in settings.json, frontmatter validity, and adapter availability. Use when something feels off, before committing config changes, or to confirm a healthy setup. Wraps `agent-stack doctor`; exit code 1 means there are issues to fix.

- **Type:** Skill
- **Install:** `agentstack add skill-drmahdikazempour-agent-stack-stack-doctor`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [drmahdikazempour](https://agentstack.voostack.com/s/drmahdikazempour)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [drmahdikazempour](https://github.com/drmahdikazempour)
- **Source:** https://github.com/drmahdikazempour/agent-stack/tree/main/skills/stack-doctor
- **Website:** https://www.npmjs.com/package/@drmahdikazempour/agent-stack

## Install

```sh
agentstack add skill-drmahdikazempour-agent-stack-stack-doctor
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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.md` description ≤ 1024 chars (Agent Skills hard limit).
- Each `SKILL.md` body ≤ 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
1. Run `npx @drmahdikazempour/agent-stack doctor`.
2. If it exits non-zero, surface each failure with the file and the limit it broke.
3. For auto-fixable issues (e.g. CLAUDE.md over budget), offer `npx @drmahdikazempour/agent-stack optimize`.
4. For hook conflicts, never hand-edit `settings.json` — re-run `init`/`profile use` so the merger reconciles them.

`--skills-only` lints just the SKILL.md files (used in CI).

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [drmahdikazempour](https://github.com/drmahdikazempour)
- **Source:** [drmahdikazempour/agent-stack](https://github.com/drmahdikazempour/agent-stack)
- **License:** MIT
- **Homepage:** https://www.npmjs.com/package/@drmahdikazempour/agent-stack

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-drmahdikazempour-agent-stack-stack-doctor
- Seller: https://agentstack.voostack.com/s/drmahdikazempour
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.