Creating a skill

A skill in Skuilds is an authored tree, served to agents over MCP:

• Skill — the umbrella (one MCP endpoint): a name and a description (the trigger — when should an agent use this?).
• Sections — the repeatable workflow (the SKILL.md body). Each has a title, a when-to-use trigger, and the content an agent retrieves. Keep them focused — agents pull the relevant section, not the whole skill.
• Branches — optional, user-named groups of nodes (e.g. a Clients branch with a node per client, or Projects, References). A node is a name + when-to-use + content. Branches let the umbrella workflow stay reusable while client- or project-specific context hangs beneath it.

The workspace

Both New skill and the skill’s Edit tab use a three-pane workspace: a left tree (SKILL.md, Sections, your branches), a center editor for whatever you select, and a toolbar. Selecting an item opens just that item — no endless scroll.

Four ways to start

Open New skill. You can mix these:

1. From scratch — name it, write the description, add sections.
2. From a template — the Templates toolbar fills a sensible structure (Tax workflow, Consulting playbook, Support runbook, …), then edit.
3. Generate with AI (Describe) — write a few sentences; the AI drafts a structured skill (name, description, sections) you review before saving.
4. Paste → structure — drop in existing notes/docs and let the AI reorganize them into clean sections without inventing facts.

AI generation uses your own Anthropic or OpenAI key. Add it once under Account → AI provider (encrypted, never shown again). Generation only prefills — nothing saves until you click save.

Adding branches and nodes

Branches attach to a saved skill, so add them on the skill’s Edit tab: Add branch (give it a name like Clients and a when to use), then Add node under it (e.g. a client’s name + their specific context). The umbrella workflow can point agents to them — e.g. “if a client overlay exists, fetch it before proceeding.”

Preview vs. edit

Opening an existing skill shows a read-only preview — a rendered SKILL.md-style document (front-matter + sections + branches) so you see what you’ve authored at a glance. Click Edit (or any item in the tree) to switch into editing; toggle back to Preview anytime.

Next: Organize skills with lists and map angles in the graph workspace.