Agent skills field notes

Make the hidden layer visible.

Six practical guides for understanding where skills live, which signals matter, and how to keep cleanup reversible.

Create a trustworthy local inventory and read every signal in context.

Combine log evidence, recency, duplicates, and human review.

Map user, shared, system, plugin, and project scope.

Measure name-and-description discovery metadata and apply the estimate to real decisions.

Compare names, paths, sources, content hashes, and precedence.

Use a dry run, a durable ledger, path guards, and a final scan.