Vibe Trade

1---
2# ─── Identity ────────────────────────────────────────────────────────────
3id: mytemplate
4name: My Template Skill
5tagline: Template
6description: One-sentence description of what this skill does. Shown as a tooltip on the chip.
7version: 0.0.1
8author: Your Name
9category: general
10icon: sparkles
11color: "#ff6b00"
12 
13# ─── Tools ───────────────────────────────────────────────────────────────
14# Every id here MUST exist in skills/tools.py::TOOL_CATALOG. Unknown ids
15# print a warning at registry load time. The frontend tool registry
16# enforces this allowlist — a skill that emits a tool_call for an id not
17# declared here will be rejected with a console warning.
18tools:
19  - script_editor.load
20  - bottom_panel.activate_tab
21  - notify.toast
22 
23# ─── Bottom panel tabs ───────────────────────────────────────────────────
24# Tabs this skill contributes. `component` must match a key in
25# apps/web/src/components/BottomPanel.tsx::BOTTOM_PANEL_COMPONENTS.
26output_tabs:
27  - id: mytemplate_output
28    label: My Output
29    component: PatternContent
30 
31# ─── Store slots (documentation only) ────────────────────────────────────
32store_slots: []
33 
34# ─── Chat input hints ────────────────────────────────────────────────────
35# When this is the only active skill, these override the chatbox UI.
36input_hints:
37  placeholder: "Describe what you want the template skill to do..."
38  supports_fingerprint: false
39---
40 
41# My Template Skill
42 
43## Purpose
44 
45Replace this paragraph with one or two sentences describing what this skill
46does and the user-facing outcome it produces. Keep it concrete — "generates
47an equity curve from fundamental data" is better than "does financial stuff".
48 
49## When to use this skill
50 
51Bullet list of situations where Vibe Trade should dispatch to this skill:
52 
53- When the user asks for ...
54- When context contains ...
55- When the chart panel provides ...
56 
57Be specific. If two skills could plausibly handle the same message, the
58"when to use" sections decide which one Vibe Trade picks.
59 
60## Instructions
61 
62Numbered, imperative steps that describe exactly what the skill's processor
63should do for each input shape:
64 
651. **If the message is type A:** do X, emit tool Y, return Z.
662. **If `context.foo` is present:** branch into the Y workflow.
673. **Otherwise:** default behavior.
68 
69Keep each step testable and concrete. The less ambiguity, the less
70LLM-induced drift.
71 
72## Inputs
73 
74| Key | Type | Meaning |
75|---|---|---|
76| `message` | string | The user's chat message |
77| `context.<key>` | *type* | Whatever your skill cares about from the router |
78 
79## Outputs
80 
81Describe what the `SkillResponse` will contain:
82 
83- `reply` — ...
84- `script` — optional ...
85- `data.*` — optional ...
86 
87## Tools used
88 
89| Tool | When | Payload |
90|---|---|---|
91| `script_editor.load` | When a script is generated | The JS source string |
92| `bottom_panel.activate_tab` | After generating output | The target tab id |
93| `notify.toast` | For transient status messages | `{level, message}` |
94 
95## Examples
96 
97**Example 1**
98> User input: "Do the thing with the stuff."
99 
100→ What the skill returns and why.
101 
102**Example 2**
103> User input: (a more complex variant)
104 
105→ How the skill handles it differently.
106 
107## Underlying implementation
108 
109This template has no Python processor yet. To wire it up:
110 
1111. Add an `async def _mytemplate_processor(message, context, tools)` in
112   `core/agents/processors.py`
1132. Register it in the `PROCESSORS` dict:
114   ```python
115   PROCESSORS = {
116       ...,
117       "mytemplate": _mytemplate_processor,
118   }
119   ```
1203. Restart the backend. The `VibeTrade.dispatch("mytemplate", ...)` call
121   will now route here.
122 
123## Frontmatter reference
124 
125| Field | Type | Description |
126|---|---|---|
127| `id` | string | Unique kebab-case identifier (also the folder name) |
128| `name` | string | Full display name shown in the chip row |
129| `tagline` | string | Short label (1 word) for compact UI |
130| `description` | string | One-sentence description; shown as a tooltip |
131| `version`, `author` | string | Informational, surfaced in a future "skill info" UI |
132| `category` | string | `analysis`, `generation`, `simulation`, etc. (free-form) |
133| `icon` | string | Icon name; resolved on the frontend. Unknown icons fall back to sparkle |
134| `color` | string | Hex color used for the chip accent |
135| `tools` | string[] | Allowlist of tool ids from `skills/tools.py::TOOL_CATALOG` |
136| `output_tabs` | object[] | Bottom-panel tabs this skill contributes |
137| `store_slots` | string[] | Documentation-only: store keys this skill writes |
138| `input_hints.placeholder` | string | Chat textarea placeholder when this is the only active skill |
139| `input_hints.supports_fingerprint` | bool | `true` if your skill accepts SHAPE fingerprints from the chart selector |
140 
141## Available tools
142 
143See `skills/tools.py::TOOL_CATALOG` for the full list. The tool categories
144are:
145 
146- **`chart.drawing.*`** — activate a drawing tool (trendline, rectangle, fib, etc.)
147- **`chart.pattern_selector`** — open the pattern selector to capture a fingerprint
148- **`chart.highlight_matches`** / **`chart.draw_markers`** — chart overlays
149- **`chart.focus_range`** / **`chart.set_timeframe`** — chart navigation
150- **`chatbox.card.strategy_builder`** — inject the strategy builder form in chat
151- **`chatbox.card.generic`** — inject a generic card with title/body/actions
152- **`bottom_panel.activate_tab`** / **`bottom_panel.set_data`** — bottom panel control
153- **`script_editor.load`** / **`script_editor.run`** — code editor control
154- **`data.indicators.add`** / **`data.indicators.toggle`** — indicator registry
155- **`notify.toast`** — user notifications
156 
157Only declare tools in the frontmatter that your processor actually uses.
158The frontend tool registry rejects any tool_call whose id isn't in the
159skill's declared list.
160