claude/skills/notion/SKILL.md
Look up information in Notion. Use when asked to find, read, or search a Notion page.
npx skillsauth add iainmcl/dotfiles notionInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Use the Notion MCP to search and fetch pages. Follow the efficiency rules below to minimise token usage.
Check /home/iainmclaughlan/notes/hitchhiker/ for a local note before touching the MCP. Direct Read/Grep is cheaper than any MCP call.
notion-search returns highlight snippets in results. If the snippet answers the question, stop — do not fetch the full page.
When a notion-fetch result is saved to a file (it will tell you the path), use Grep to find the relevant section rather than reading the file in chunks:
Grep "destructive migration" <output_file_path>
If the search highlight is insufficient, fetch the page — but immediately Grep the output file for the specific section needed rather than reading it all.
If a page is likely to be referenced again, save a condensed version to Obsidian so future lookups are free:
/home/iainmclaughlan/notes/hitchhiker/<topic>.md
notion-search with a focused querynotion-fetch the page, then Grep the output file for the specific contentdevelopment
Run a weekly achievement review - pulls from Jira, GitHub, and Slack to capture what you shipped in the last week, maps achievements to your 2026 goals, and appends impact-focused entries to your brag doc. Use when asked to "do a weekly review", "capture this week's wins", "update my brag doc", "what did I ship this week", "record my achievements", "what have I done this week", "add to my performance doc", or anything about tracking weekly progress, brag doc entries, or performance evidence. Trigger even if the user just says "weekly review" or "document what I did".
testing
Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.
tools
Set up a project update config for the current repo, so that running project-update requires no setup questions. Use when asked to "set up project updates", "configure project update", "initialise project update", or "create a project update config". Run this once per project repo.
testing
Find the highest-frequency unresolved Sentry error for the VAT & Invoicing or Billing team, understand its root cause, create a Jira ticket in the APP project, implement a fix, and open a draft PR. Use when asked to "fix sentry issues", "triage sentry errors", "look at sentry", "what's broken in sentry", "create a fix for a sentry issue", or "sentry triage". Runs the full flow autonomously in the background.