Install
npx skillscat add ianphil/my-skills/ainotes Install via the SkillsCat registry.
SKILL.md
AI Notes — Consolidate
Consolidate raw session observations from .ainotes/log.md into a curated .ainotes/summary.md.
Workflow
- Check if
.ainotes/directory exists in the repo root. If not, create it with emptysummary.mdandlog.md. - Read
.ainotes/log.md— these are raw observations appended by the commit skill. - Read
.ainotes/summary.md— this is the current curated summary. - Consolidate log entries into summary:
- Merge new observations into the appropriate section
- Deduplicate — if a fact is already in summary, skip it
- Merge related observations into single concise entries
- Prune stale info that contradicts newer observations
- Keep summary under ~200 lines (hard limit)
- Write updated
summary.md - Truncate
log.md— keep only the last 10 entries as a buffer, remove everything else.
summary.md Format
Use structured sections. Only include sections that have content:
# AI Notes — <project name>
## Architecture
- <observation>
## Gotchas
- <observation>
## Workflows
- <observation>
## Testing
- <observation>
## Dependencies
- <observation>
## Conventions
- <observation>Rules
- Every bullet must be a terse one-liner — no paragraphs
- Prefer specifics over generalities (file paths, command names, exact behavior)
- If summary exceeds ~200 lines, aggressively prune least-useful entries
- Never duplicate information already in README.md or AGENTS.md
- When merging contradictory observations, keep the newer one