CommunityWriting & Editinggithub.com

SimaAlexandru99/agentscan

Find broken agent config: hooks whose scripts are gone, MCP/skills that disagree with disk. No network.

What is agentscan?

agentscan is a Claude Code agent skill that find broken agent config: hooks whose scripts are gone, MCP/skills that disagree with disk. No network.

Works with✓Claude Code~Codex CLI~Cursor
npx skills add SimaAlexandru99/agentscan

Installed? Explore more Writing & Editing skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

View original→Browse all skills

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Documentation

What does agentscan do?

Read-only linter for agent config. Findings are facts.

When

  • Hook, skill, MCP, or AGENTS.md work
  • Someone says a guard is on and you have not verified the script
  • A PR touches .claude/, .commandcode/, .agents/, .mcp.json, or skills-lock.json

Do

From the repo root:

npx @chimix/agentscan@latest --output prompt

--output prompt is the handoff for the agent that fixes. Do not skip claude.hook.missing-script (error).

No project handy:

npx @chimix/agentscan@latest demo

demo builds a throwaway fixture, prints the report, and deletes the fixture.

Don't

  • Write the scanned tree
  • Guess with the model whether a hook is valid
  • Compare a skill's frontmatter name to its directory, or validate model ids

Related Skills

steipete/notion

Notion CLI/API for pages, Markdown content, data sources, files, comments, search, Workers, and raw API calls.

community

langchain-ai/langchain

The agent engineering platform.

community

bytedance/podcast-generation

Use this skill when the user requests to generate, create, or produce podcasts from text content. Converts written content into a two-host conversational podcast audio format with natural dialogue.

community

composiohq/twitter-algorithm-optimizer

Analyze and optimize tweets for maximum reach using Twitter's open-source algorithm insights. Rewrite and edit user tweets to improve engagement and visibility based on how the recommendation system ranks content.

community

composiohq/competitive-ads-extractor

Extracts and analyzes competitors' ads from ad libraries (Facebook, LinkedIn, etc.) to understand what messaging, problems, and creative approaches are working. Helps inspire and improve your own ad campaigns.

community

upstash/context7

Context7 Platform -- Up-to-date code documentation for LLMs and AI code editors

community
← More Writing & Editing skills