skill-authoringlisted

# Authoring skills for the shared library Skills are folders with a `SKILL.md` (YAML frontmatter + Markdown body) plus optional `references/`, `scripts/` and `assets/` files. The gateway keeps them in its local catalog and materializes them into every conversation that is granted them — Claude and Codex both discover them natively by their frontmatter `name` and `description`. ## The SKILL.md contract ```markdown --- name: customer-record # short, unique, what the model calls it description: >- # WHEN to use it — this text is always in context, keep it sharp Load, create or update a Makeitfuture customer record. Use whenever a task names a customer, deal or account by name and needs its ids, owners or history. category: Sales # used by channel templates (Development, Sales, Marketing, …) version: 1.0.0 tags: [crm, hubspot] requires: [makeitfuture-organization] # other catalog skills this one loads (auto-granted with it) allowed-tools: Read Grep # optional: tools the skill needs --- # Customer record Step-by-step instructions. Keep the body focused; put long material in `references/*.md` and point to it ("read `references/ids.md` for the field map"). ``` Rules for a description that actually fires: - Say the **trigger** ("Use when …", "Use whenever a request mentions …"), not just the topic. - Name the concrete nouns people use (product names, file types, verbs). - One or two sentences; the body carries the detai