agent-builder/commands/status.md

description	argument-hint	allowed-tools
Quick status check of your agent infrastructure. Shows agents, skills, hooks, deployment, and recent activity.		Read Glob Grep Bash

You are running /agent-factory:status — a quick health check of your agent infrastructure.

Scan and report

Run all scans, then output a single compact status report.

Agents

Glob for .claude/agents/*.md. For each agent file:

• Read the frontmatter to extract: name, model, tools count
• List as: [name] (model: [model], tools: [N])
• Flag: agents without <example> blocks in description (unreliable triggering)

Skills

Glob for .claude/skills/*/SKILL.md and .claude/skills/*.md. For each:

• Read frontmatter to extract: name, version (if present)
• List as: [name] v[version]
• Flag: skills without version field

Hooks

Glob for .claude/hooks/*.sh and hooks/*.sh. For each:

• Check if executable: test -x [path]
• List as: [filename] ([executable/not executable])
• Flag: hook scripts that are not executable

Settings

Read .claude/settings.json if it exists:

• Count permission allow rules and deny rules
• Count hook configurations
• Summarize: [N] allow rules, [M] deny rules, [K] hooks configured

Deployment

Check for:

• automation/*.sh → "Local automation scripts found"
• automation/*.plist → "launchd config found"
• automation/*.service → "systemd config found"
• docker-compose.yml or Dockerfile → "Docker config found"
• HEARTBEAT.md → "Heartbeat file found"

Memory

Check for:

• memory/MEMORY.md → "Long-term memory: found"
• memory/SESSION-STATE.md → "Session state: found"
• memory/*.md (daily logs) → "Daily logs: [N] files"
• data/run-state.json → "Run state: found"

Recent activity

If .claude/hooks/audit.log or hooks/audit.log exists:

• Read last 5 lines
• Display as recent tool call log

Issues

Compile all flags from above into an issues list:

• "WARNING: [agent] has no example blocks — may not trigger reliably"
• "WARNING: [hook] is not executable — run chmod +x"
• "WARNING: No hooks configured — unattended runs have no guardrails"

Output format

AGENT FACTORY STATUS
====================

Agents:     [N] configured
Skills:     [N] loaded
Hooks:      [N] configured ([M] executable)
Settings:   [allow/deny/hooks counts]
Deployment: [target or "not configured"]
Memory:     [tiers found]

Issues: [N]
[list if any]