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.
/compress-video Compress a video file using the local compress-video CLI (ffmpeg wrapper — 1080p, 24 fps, H.264 2500k, AAC 192k). Use when asked to compress, shrink, lighten or convert a video, or to concatenate clips.
/cra Suivi du temps : clôture mensuelle des CRA (Toggl → Billi → facture Qonto), réconciliation des sources, reconstitution des journées mal trackées.
/create-skill Create a new Claude Code skill based on conversation context, a file, or a description of the skill’s purpose.
/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, or enable GitHub auto-merge with –auto. Usage: /merge [–auto] [pr-number]
/new-project Scaffold a new full-stack project with backend (Scalingo) and Next.js frontend (Cloudflare Workers), initialize git/GitHub, and plan using GitHub issues.
/notion-note Write an internal note in the Qraft Notion Tech subpage (French, long-form voice) from the current session, a file, or a topic. Internal only — never published or cross-posted.
/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”.
/publish Turn a piece of content into a qraft.tech blog article (FR + EN) plus a LinkedIn and an X post, all scheduled on the next free Mon/Thu slot at least 48h out. No validation step — the 48h are the review window.
/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.
/qonto-receipts Audit missing receipts (justificatifs) on Qonto transactions for any org (gybe, qraft), excluding lost/not-required ones. Then hunt recoverable invoices by email/portal and attach them to the right transaction.
/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.
/toggl-calendar Per-day, per-client timesheet calendar from Toggl. Shows work days per client per day, in 0.5-day increments with carry-forward rounding. Can also clean anomalies (overnight timers, missing lunch breaks) and reassign unattributed entries to clients.
/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

This site uses Just the Docs, a documentation theme for Jekyll.