Claude Documentation

This folder contains documentation, guides, and notes related to Claude and Claude Code. It serves as a personal wiki for configuration, workflows, tips, and integrations.

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)

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.
/cii	Dossier CII/CIR : accès Finalli, données de référence, extraction temps personnel pour les déclarations de crédit d’impôt innovation.
/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.
/pr	Commit changes, create a branch, push, and open a pull request. If working from an issue, automatically links it with “Closes #X”.
/promote-permissions	Review ephemeral permissions in settings.local.json and promote approved ones to versioned settings.json, then create a PR
/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 whisper-cpp (whisper-cli) with automatic format conversion.
/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
May 11, 2026	63 (of 81)	1,569	50
February 10, 2026	234	659	266

Structure

claude/
├── README.md          # This file - index of all documentation
├── CLAUDE.md          # Global instructions for all Claude Code sessions
├── .claude/
│   └── skills/        # Custom Claude Code skills (see Skills section above)
├── config/            # Configuration files (symlinked from ~/.claude/)
│   └── settings.json  # User-level Claude settings
├── guides/            # Step-by-step tutorials and how-tos
├── insights/          # Usage analysis reports from /insights command
│   └── report-*.html  # Self-contained HTML reports with usage patterns
└── notes/             # Personal notes and learnings

Quick Setup

The following files are symlinked from ~/.claude/ to this repo:

# Global instructions (loaded in every session)
ln -sf ~/dev/claude/CLAUDE.md ~/.claude/CLAUDE.md

# User-level settings
ln -sf ~/dev/claude/config/settings.json ~/.claude/settings.json

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