Skip to content

fix: add missing tools declarations to agent-sdk-verifier agents#196

Open
xiaolai wants to merge 1 commit intoccplugins:mainfrom
xiaolai:fix/nlpm-verifier-tools-declarations
Open

fix: add missing tools declarations to agent-sdk-verifier agents#196
xiaolai wants to merge 1 commit intoccplugins:mainfrom
xiaolai:fix/nlpm-verifier-tools-declarations

Conversation

@xiaolai
Copy link
Copy Markdown

@xiaolai xiaolai commented Apr 21, 2026

Automated audit: This PR was generated by NLPM, a natural language programming linter, running via claude-code-action. Please evaluate the diff on its merits.

Bug

Both plugins/agent-sdk-dev/agents/agent-sdk-verifier-ts.md and agent-sdk-verifier-py.md have no tools: declaration in their frontmatter, but their bodies explicitly require tools:

  • agent-sdk-verifier-ts.md step 3 instructs: "Run npx tsc --noEmit to check for type errors" → requires Bash. Step 2 instructs: "Use WebFetch to reference the official TypeScript SDK docs" → requires WebFetch. Reading project files requires Read.
  • agent-sdk-verifier-py.md steps instruct reading requirements.txt, pyproject.toml, etc. → requires Read. Checking SDK docs → requires WebFetch. Running pip/python validation commands → requires Bash.

Impact

Without a tools: declaration, Claude Code does not grant the agent access to any tools. The verification steps that call Bash or WebFetch silently produce no output or an error, making the agent appear to complete but actually skip its most critical checks (type-checking, dependency validation, SDK doc comparison).

Fix

Add tools: Bash, Read, WebFetch to the frontmatter of both verifier agents — the minimal set required by their documented verification procedures.

Both agent-sdk-verifier-ts.md and agent-sdk-verifier-py.md had no
tools declared, but their bodies explicitly require Bash (for running
tsc/pip) and WebFetch (for fetching SDK docs). Without the tools
declaration, Claude Code cannot grant the agent access to these tools
and verification steps silently fail.

Co-Authored-By: Claude Code <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant