Write Best Practice Profile

Create a .grimoire/profiles/<name>.toml file that bundles a curated set of skills for a paradigm, team, or project context.

Why This Is Best Practice

Adopted by: Every major toolchain uses guided authoring for shared configuration — ESLint's --init, create-react-app, nx generate, and VS Code's profile export all guide users through structured configuration creation rather than expecting manual file editing. Impact: Manual TOML authoring leads to invalid skill names, missing required fields, and profiles that fail silently at activation time. A guided creation flow catches these errors before the file is written. Why best: A profile is only as good as its skill list. Guided creation ensures each skill name is validated against installed skills at write time — not discovered as a broken reference at activation time.

Sources: XDG Base Directory Specification (freedesktop.org); Grimoire docs/profiles.md

Steps

1. Gather profile identity

Ask:

• Name (slug, lowercase, hyphens): e.g. my-team, backend-defaults, frontend-strict
• Description (one sentence): when should someone activate this profile?