Files
2025-11-30 08:38:32 +08:00

1.9 KiB

name, description, allowed-tools
name description allowed-tools
skill-name Use when [analyzing/investigating/reviewing] [specific thing]. Read-only analysis that finds [patterns/issues/metrics]. Mentions of [keywords], [error types], or [analysis needs] trigger this. Read, Grep, Glob

Skill Name (Read-Only Analysis)

Brief statement of purpose - what does this analyze and why?

Instructions

This is a read-only skill. Follow these steps to provide thorough analysis:

  1. Find all relevant files: Use Glob to locate files matching the criteria
  2. Search for patterns: Use Grep with context (-C flag) to find issues
  3. Read detailed content: Use Read on specific files for deeper analysis
  4. Correlate findings: Connect patterns across multiple files
  5. Summarize with evidence: Provide findings with file paths and line numbers

Example

# Find all relevant files
glob "**/*.log"

# Search with context
grep -C 5 "ERROR|WARN" application.log

# Read specific file for details
read config/settings.json

Expected analysis:

Found 3 ERROR entries in application.log:
- Line 42: Database connection timeout
- Line 156: Failed authentication attempt
- Line 289: Memory allocation error

Root cause: Database connection timeout at line 42 triggered cascade of errors.
Recommendation: Investigate database connection pool settings.

Anti-Patterns

Red Flags:

  • "I found some errors" ← Where? Which files? What lines?
  • "The logs show issues" ← What specific issues? How do they correlate?
  • "I'll just check one file" ← Did you search all relevant files?

Why these fail: Incomplete analysis misses context and root causes.

Tool Restrictions

This skill is read-only by design:

  • ✓ Can: Read files, search content, find patterns
  • ✗ Cannot: Modify files, execute commands, write files

If modifications are needed, recommend creating a separate skill or getting user permission.