Agent Skills

Curated public subset of my Claude Code setup: generic skills, guides, and usage insights reports. My live configuration (settings, permissions, client-specific skills) lives in a private repo — everything published here goes through scripts/scan_sensitive.sh first.

Guides

Document	Description
Settings Architecture	Complete guide to Claude Code settings hierarchy, permissions, and MCP configuration
MCP Server Scopes	The three MCP server scopes (user, project, local) and when to use each
MCP Servers	Inventory of all configured MCP servers — what they do and how they’re scoped
Slack MCP Setup	How to configure the Slack MCP server
Audio Notifications	How to set up audio notifications for Claude Code events (task completion, idle, permissions)

Knowledge

Repo-scoped knowledge files Claude reads to do its job well — durable context referenced from CLAUDE.md and maintained via /update-knowledge.

Document	Description
Writing Style	Nicolas’s voice (universal) and per-channel formatting (Slack, email, Notion long-form, GitHub).

Skills

Custom slash commands available in Claude Code. The table below is auto-generated by scripts/sync_docs.py from each skill’s SKILL.md frontmatter — do not edit by hand.

Skill	Description
/billi-cra	Import CRAs from an Excel file into Billi, or export CRAs from Billi to Excel. Bidirectional sync of activity reports.
/cloudflare-workers-nextjs	Deploy a Next.js 16 app to Cloudflare Workers via OpenNext, with Workers Builds for automatic PR preview deployments.
/cra	Suivi du temps : réconciliation Toggl, Billi CRA et git commits. Vue d’ensemble et détection d’écarts entre les sources.
/create-skill	Create a new Claude Code skill based on conversation context, a file, or a description of the skill’s purpose.
/cross-post	Cross-post content to LinkedIn, Twitter/X, and Slack. Adapts content to each platform’s format and constraints.
/find-skills	Helps users discover and install agent skills when they ask questions like “how do I do X”, “find a skill for X”, “is there a skill that can…”, or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
/gogcli	CLI for Gmail, Calendar, Drive, Contacts, Tasks, Sheets.
/merge	Merge a PR (with merge commit) and prune merged branches. Usage: /merge [pr-number]
/new-project	Scaffold a new full-stack project with backend (Scalingo) and Next.js frontend (Cloudflare Pages), initialize git/GitHub, and plan using GitHub issues.
/notion-article	Write and publish a blog article to Notion based on conversation context, a file, or a topic. Optionally cross-post to LinkedIn, Twitter, and Slack.
/notion-pdf	Render a Notion page (commercial proposal, client doc) as a Qraft-branded PDF, faithful to the Notion content. Notion markdown -> styled HTML -> PDF via headless Chrome.
/pr	Commit changes, create a branch, push, and open a pull request. If working from an issue, automatically links it with “Closes #X”.
/qonto-invoices	Analyse des factures clients Qonto par période de prestation (pas date d’émission) et compte de destination. Sortie HT/TTC, top clients, audit des cas ambigus.
/review-apply	Apply PR review feedback — reply to questions and implement requested changes. Usage: /review-apply [pr-url-or-number]
/sentry-triage	Triage unresolved Sentry issues for any project. Analyze errors, identify root causes, prioritize by impact, and optionally apply fixes or update issue status.
/tmba-process	Process a “Tech My Breath Away” meeting: move the Fireflies-created Notion page to the Talks database, and upload the video to Google Drive.
/transcribe	Transcribe audio files using the local transcribe CLI (WhisperX large-v3 + diarisation + optional LLM correction).
/update-knowledge	Update .claude/knowledge/ files with architectural context and design rationale learned during the current session.
/workspace	Read open Cursor editor tabs to understand what the user is working on.

Insights Reports

The insights/ directory contains usage analysis reports generated by Claude Code’s /insights command. These reports analyze session patterns, tool usage, friction points, and recommendations.

Report	Sessions	Hours	Commits
July 7, 2026	137 (of 153)	1,920	90
May 11, 2026	63 (of 81)	1,569	50
February 10, 2026	234	659	266

Structure

agent-skills/
├── README.md          # This file - index of all documentation
├── .claude/
│   ├── knowledge/     # Repo-scoped knowledge files (see Knowledge section above)
│   └── skills/        # Custom Claude Code skills (see Skills section above)
├── guides/            # Step-by-step tutorials and how-tos
├── insights/          # Usage analysis reports from /insights command
│   └── report-*.html  # Self-contained HTML reports with usage patterns
└── scripts/           # Docs sync + pre-publish sensitive-terms scan

Adding a New Document

1. Create a new .md file in the appropriate folder
2. Add an entry to the relevant table above
3. Use descriptive filenames (e.g., mcp-server-setup.md)

Adding a New Skill

1. Create .claude/skills/<name>/SKILL.md with name and description in the frontmatter
2. Run python scripts/sync_docs.py to regenerate the Skills tables in README.md and skills.md
3. Commit the skill and the regenerated tables together — CI fails on drift