SKILL.md

name: addressing-agent-comments description: Finds AGENT comments in code, gathers feedback, and carries out requested changes. Use when scanning a repo for inline agent notes, decision requests, or tooling tags. metadata: source: https://github.com/ampcode/amp-contrib

Search for inline AGENT: comments, read the surrounding code, and follow through on the request.

When to use

  • You need to collect and resolve inline agent notes or change requests
  • A repo uses a tag like AGENT: to point at work items
  • You are asked to scan for inline feedback embedded in code

Search process

  1. Identify the instruction tag for the repo. Default to AGENT: if none is provided.
  2. Use ripgrep to find the tag with context:
rg -n --fixed-strings "AGENT:" -C 3
  1. If multiple tags are used, repeat the search for each tag.

Review process

  • Read each comment with surrounding code to understand scope and intent
  • Make the change or address the concern where feasible
  • If a request is unclear, document assumptions and raise questions
  • Update or remove resolved AGENT: comments

Output format

  • Group findings by file path
  • Include line numbers and relevant context for each comment
  • Summarize key themes and action items at the end

Expected actions

After finding AGENT: comments:

  1. Analyze the request in each comment
  2. Make the change, or explain why you did not
  3. Resolve or update the instruction comment
  4. Provide a brief summary of actions taken and any open questions