Create a skill in the Workshop

The Skill Workshop is Cerevisor's in-app editor for building new skills or editing existing ones. Switch to it from the title bar (the Workshop icon). License gate: The Workshop's edit surface is gated on Trial+ / Paid tiers. Free-tier users can browse skills in the Workshop but can't save changes. Workshop layout Three panes: Pane Content Skill List (left) Every skill Cerevisor found, grouped by source folder. Click a skill to load it into the editor. Editor (center) The active skill's SKILL.md editor, plus metadata fields. Validation (right) Real-time validation: errors, warnings, info messages about your current skill. Creating a new skill Click + New skill above the skill list. The Workshop's create dialog offers three entry tabs: Tab What it does Generate Describe what you need in plain language; Cerevisor's chat-capable provider drafts a SKILL.md you can edit. Only shown when at least one chat-capable provider (Anthropic, Gemini, OpenAI-compatible) is configured. Template Pick one of five hand-rolled scaffolds (see Templates below). Blank One click. Drops you into the editor with the bare-minimum SKILL.md frontmatter so you can build from scratch. For Generate and Template, you also pick: Field What it does Skill name Required. The folder name and name: frontmatter value. Use kebab-case. Location ~/.claude/skills/ (shared with Claude Code) or ~/.cerevisor/skills/ (Cerevisor-only). Click Create . The skill folder is generated and you're dropped into the editor. The editor The editor has these sections: Metadata Name : text input. The name: frontmatter value. Description : textarea. The description: frontmatter value. This is the most important field for skill discoverability: see What are skills? . Category : dropdown to organize the skill in the panel. Tags : chip input. Body editor A Monaco editor for the body of SKILL.md . Markdown with syntax highlighting. Supports tables, code blocks, callouts. Below the editor is a live markdown preview tab. Auto-save Edits debounce-save to disk every few seconds. The editor shows a "Saving…" / "Saved" indicator. There's no explicit Save button. Delete A trash icon at the bottom removes the skill. Confirms first. Only available for skills under ~/.cerevisor/skills/ , Cerevisor doesn't delete skills it didn't write. Validation The validation pane updates as you type. It surfaces: Severity Examples Error Missing required name: or description: frontmatter. Invalid YAML. Malformed markdown structure. Warning Description shorter than 50 chars (probably too vague). No "when to use" hint. No "when NOT to use" hint. Info Suggestions for improving discoverability — adding tags, mentioning common triggers, etc. Errors block the skill from showing up in agent pickers. Warnings don't block but indicate poor discoverability. Templates The five built-in templates available under the Template tab: Template Best for Development Tool Coding, debugging, and testing patterns. Scaffolds before/after examples, core pattern

Back to docs