skill-creator

1# Skill Creator
2 
3This skill provides guidance for creating effective skills.
4 
5## About Skills
6 
7Skills are modular, self-contained folders that extend Bub's capabilities by providing
8specialized knowledge, workflows, and tools. Think of them as "onboarding guides" for specific
9domains or tasks—they transform Bub from a general-purpose agent into a specialized agent
10equipped with procedural knowledge that no model can fully possess.
11 
12### Skill Location Policy
13 
14When creating a skill, place it in one of these two roots:
15 
161. Project-local: `$workspace/.agents/skills/<skill-name>`
172. Global: `~/.agents/skills/<skill-name>` (shared across workspaces)
18 
19Prefer project-local by default. Use global only when the user explicitly wants the skill available across multiple workspaces.
20 
21### What Skills Provide
22 
231. Specialized workflows - Multi-step procedures for specific domains
242. Tool integrations - Instructions for working with specific file formats or APIs
253. Domain expertise - Company-specific knowledge, schemas, business logic
264. Bundled resources - Scripts, references, and assets for complex and repetitive tasks
27 
28## Core Principles
29 
30### Concise is Key
31 
32The context window is a public good. Skills share the context window with everything else Bub needs: system prompt, conversation history, other Skills' metadata, and the actual user request.
33…