I think the majority here have stated the same... That CLAUDE.md or AGENTS.md effectively do this. Either that or the readme.

The only tip I can give is that your skill that builds or wraps up work. You should have it update those files if anything has changed.

Claude/Agents files shouldn't be bloated, but should imho act as a basic amount of context on the project so your agent and skills can pick up and go, with even the most basic initial prompt.

> The only tip I can give is that your skill that builds or wraps up work. You should have it update those files if anything has changed.

Depending on the scope of work you’re doing, it might be better to have this removed from the context of the work that was done.

I keep a “Last Updated Hash” in my md and every so often will have the LLM pull a diff from that hash to the current head, then determine what doesn’t match.