Learn
Direct answers to common problems with agent skills and instruction files, each with a worked example and sources.
- Why isn't my Claude skill triggering?
The usual causes of a Claude Code skill that never fires, in the order to check them, with a worked example and the commands that find them.
- AGENTS.md vs CLAUDE.md vs Cursor rules: keeping them in sync
Which agent reads which instruction file, why copies drift apart, and a low-effort way to keep one source of truth.
- Are agent skills safe? What to check before installing one
A skill is text plus optional scripts that your agent runs with your permissions. What to read, what to scan for, and what our scan of 511 popular skills found.
- How to write a SKILL.md description that triggers
The description is the only part of a skill the agent reads before deciding to load it. A formula, a before-and-after, and a check you can run.
- Why does my agent forget rules after compaction?
Long sessions get compacted, and users report rules from CLAUDE.md being ignored afterwards. What is known, what helps, and what Skillhawk does not do.