SKILL.md
Sigil
Capture taste preferences for design physics.
Usage
/sigil "insight to record"
/sigil --statusPhilosophy
Taste is personal physics. When users modify generated code, they're tuning physics to their context. Sigil captures why.
- Free-form over schema — No YAML frontmatter, just markdown paragraphs
- Append-only — Never edit taste.md, only append
- Human writes, Claude reads — /sigil is for humans to record insights
Workflow: Record (/sigil "insight")
- Format insight with timestamp header
- Append to
grimoires/rune/taste.md:
```markdown ## 2026-01-25 14:30
They prefer 500ms for financial operations, not 800ms. Their users are power traders who find default timing sluggish.
```
- Confirm: "Recorded taste observation."
Workflow: Status (/sigil --status)
- Read
grimoires/rune/taste.md - Count entries by approximate tier:
- Tier 1 (Observation): Single mention - Tier 2 (Pattern): Referenced 3+ times in generation - Tier 3 (Rule): Explicitly promoted
- Display summary:
``` ## Taste Status
Total entries: 12 - Tier 1 (Observations): 8 - Tier 2 (Patterns): 3 - Tier 3 (Rules): 1
Recent entries: - 2026-01-25: Power user timing preference (500ms) - 2026-01-24: Springs over easing curves - 2026-01-23: No modals for confirmations ```
Capture Sources
| Source | Trigger | Tier |
|---|---|---|
| Manual | /sigil "insight" |
1 (Observation) |
| Explicit rejection | User says "n" to hypothesis | 1 (Observation) |
| Implicit edit | User modifies generated code | 1 (Observation) |
| Pattern detection | 3+ similar rejections | 2 (Pattern) |
| User promotion | /sigil promote <id> |
3 (Rule) |
Maturity Tiers
| Tier | Name | Application | Confidence Boost |
|---|---|---|---|
| 1 | Observation | Applied with note | +0.00 |
| 2 | Pattern | Applied with confidence | +0.05 |
| 3 | Rule | Applied always | +0.10 |
Workflow: Promote (/sigil promote <id>)
Promote a pattern to a rule:
/sigil promote pattern-1706234567890
Promoting "Financial Timing" pattern to Rule.
This will:
- Always apply 500ms for Financial effects
- Override physics table default
- No longer ask for confirmation
Confirm? [y/n]Integration with Glyph
When /glyph runs, it reads taste.md and applies:
| Pattern | Action |
|---|---|
| Timing preferences | Adjust default physics timings |
| Animation preferences | Use preferred easing/springs |
| Component patterns | Follow established structure |
| Explicit corrections | Apply as hard rules |
Glyph notes when taste is applied:
Timing: 500ms (taste: power user preference, Tier 2)
Confidence: 0.90 (+0.05 from Tier 2 match)Rules Loaded
rules/sigil/00-sigil-core.md- Philosophyrules/sigil/01-sigil-taste.md- Reading and applying tasterules/sigil/02-sigil-capture.md- Capture protocolrules/sigil/03-sigil-maturity.md- Tier system
State File
grimoires/rune/taste.md — Append-only markdown