@vibe-agent-toolkit/vat-example-cat-agents 0.1.13 → 0.1.14
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/skills/vat-example-cat-agents/SKILL.md +34 -34
- package/dist/skills/vat-example-cat-agents/resources/SKILL.md +729 -0
- package/dist/skills/vat-example-cat-agents/{human-approval.md → resources/human-approval.md} +1 -1
- package/package.json +10 -10
- package/dist/skills/vat-example-cat-agents/CLAUDE.md +0 -424
- package/dist/skills/vat-example-cat-agents/README.md +0 -727
- /package/dist/skills/vat-example-cat-agents/{breed-advisor.md → resources/breed-advisor.md} +0 -0
- /package/dist/skills/vat-example-cat-agents/{cat-breed-selection.md → resources/cat-breed-selection.md} +0 -0
- /package/dist/skills/vat-example-cat-agents/{description-parser.md → resources/description-parser.md} +0 -0
- /package/dist/skills/vat-example-cat-agents/{haiku-generator.md → resources/haiku-generator.md} +0 -0
- /package/dist/skills/vat-example-cat-agents/{name-generator.md → resources/name-generator.md} +0 -0
- /package/dist/skills/vat-example-cat-agents/{photo-analyzer.md → resources/photo-analyzer.md} +0 -0
- /package/dist/skills/vat-example-cat-agents/{structure.md → resources/structure.md} +0 -0
|
@@ -52,8 +52,8 @@ Trigger this skill when:
|
|
|
52
52
|
Use when user has a straightforward request that maps to one agent.
|
|
53
53
|
|
|
54
54
|
**Example workflows:**
|
|
55
|
-
- "What cat breed should I get?" → [breed-advisor](breed-advisor.md)
|
|
56
|
-
- "Analyze this cat photo" → [photo-analyzer](photo-analyzer.md)
|
|
55
|
+
- "What cat breed should I get?" → [breed-advisor](resources/breed-advisor.md)
|
|
56
|
+
- "Analyze this cat photo" → [photo-analyzer](resources/photo-analyzer.md)
|
|
57
57
|
- "Is this a valid haiku?" → haiku-validator (pure function)
|
|
58
58
|
|
|
59
59
|
### Pattern 2: Sequential Pipeline (Multi-Agent)
|
|
@@ -62,11 +62,11 @@ Use when output of one agent feeds into another.
|
|
|
62
62
|
|
|
63
63
|
**Example workflows:**
|
|
64
64
|
1. Photo → Characteristics → Name
|
|
65
|
-
- [photo-analyzer](photo-analyzer.md) → [name-generator](name-generator.md)
|
|
65
|
+
- [photo-analyzer](resources/photo-analyzer.md) → [name-generator](resources/name-generator.md)
|
|
66
66
|
2. Photo → Characteristics → Haiku
|
|
67
|
-
- [photo-analyzer](photo-analyzer.md) → [haiku-generator](haiku-generator.md)
|
|
67
|
+
- [photo-analyzer](resources/photo-analyzer.md) → [haiku-generator](resources/haiku-generator.md)
|
|
68
68
|
3. Description → Characteristics → Name → Validation
|
|
69
|
-
- [description-parser](description-parser.md) → [name-generator](name-generator.md) → name-validator
|
|
69
|
+
- [description-parser](resources/description-parser.md) → [name-generator](resources/name-generator.md) → name-validator
|
|
70
70
|
|
|
71
71
|
### Pattern 3: Generate-Validate Loop (Iterative)
|
|
72
72
|
|
|
@@ -75,10 +75,10 @@ Use when generator produces content that needs validation with retry logic.
|
|
|
75
75
|
**Example workflows:**
|
|
76
76
|
1. Name generation with validation
|
|
77
77
|
- Generate → Validate → If invalid, retry with feedback
|
|
78
|
-
- Uses: [name-generator](name-generator.md) + name-validator
|
|
78
|
+
- Uses: [name-generator](resources/name-generator.md) + name-validator
|
|
79
79
|
2. Haiku generation with validation
|
|
80
80
|
- Generate → Validate → If invalid, retry
|
|
81
|
-
- Uses: [haiku-generator](haiku-generator.md) + haiku-validator
|
|
81
|
+
- Uses: [haiku-generator](resources/haiku-generator.md) + haiku-validator
|
|
82
82
|
|
|
83
83
|
**Orchestration tip:** Generator agents have NO knowledge of validation rules. This is intentional - forces iteration and tests feedback loops.
|
|
84
84
|
|
|
@@ -88,7 +88,7 @@ Use when decision requires human judgment.
|
|
|
88
88
|
|
|
89
89
|
**Example workflows:**
|
|
90
90
|
1. Breed application approval
|
|
91
|
-
- Gather info → Generate application → [human-approval](human-approval.md) → Process result
|
|
91
|
+
- Gather info → Generate application → [human-approval](resources/human-approval.md) → Process result
|
|
92
92
|
2. Name approval before finalization
|
|
93
93
|
- Generate names → Present options → Human selects → Finalize
|
|
94
94
|
|
|
@@ -98,10 +98,10 @@ Use when decision requires human judgment.
|
|
|
98
98
|
|
|
99
99
|
**When:** User wants help finding the right cat breed.
|
|
100
100
|
|
|
101
|
-
**Agent:** [breed-advisor](breed-advisor.md)
|
|
101
|
+
**Agent:** [breed-advisor](resources/breed-advisor.md)
|
|
102
102
|
|
|
103
103
|
**Orchestration strategy:**
|
|
104
|
-
1. **Phase 1 - Gathering** (see [Conversation Strategy](breed-advisor.md#conversation-strategy))
|
|
104
|
+
1. **Phase 1 - Gathering** (see [Conversation Strategy](resources/breed-advisor.md#conversation-strategy))
|
|
105
105
|
- Collect ≥4 factors including music preference
|
|
106
106
|
- ONE question at a time (don't bombard)
|
|
107
107
|
- Extract factors after each turn
|
|
@@ -117,15 +117,15 @@ Use when decision requires human judgment.
|
|
|
117
117
|
- Conclude gracefully
|
|
118
118
|
- Provide next steps or exit instruction
|
|
119
119
|
|
|
120
|
-
**Critical factor:** Music preference is the PRIMARY compatibility factor. Ask early, use as conversation anchor. See [Music Preference Insight](breed-advisor.md#music-preference-insight) for mappings.
|
|
120
|
+
**Critical factor:** Music preference is the PRIMARY compatibility factor. Ask early, use as conversation anchor. See [Music Preference Insight](resources/breed-advisor.md#music-preference-insight) for mappings.
|
|
121
121
|
|
|
122
|
-
**Reference implementation:** See [cat-breed-selection.md](cat-breed-selection.md) for detailed breed selection orchestration.
|
|
122
|
+
**Reference implementation:** See [cat-breed-selection.md](resources/cat-breed-selection.md) for detailed breed selection orchestration.
|
|
123
123
|
|
|
124
124
|
### Workflow B: Photo Analysis Pipeline
|
|
125
125
|
|
|
126
126
|
**When:** User provides a cat photo and wants analysis, name, or haiku.
|
|
127
127
|
|
|
128
|
-
**Agents:** [photo-analyzer](photo-analyzer.md) → [name-generator](name-generator.md) OR [haiku-generator](haiku-generator.md)
|
|
128
|
+
**Agents:** [photo-analyzer](resources/photo-analyzer.md) → [name-generator](resources/name-generator.md) OR [haiku-generator](resources/haiku-generator.md)
|
|
129
129
|
|
|
130
130
|
**Orchestration strategy:**
|
|
131
131
|
|
|
@@ -154,7 +154,7 @@ Optional Step 3: Validate
|
|
|
154
154
|
|
|
155
155
|
**When:** User describes a cat in text (no photo).
|
|
156
156
|
|
|
157
|
-
**Agents:** [description-parser](description-parser.md) → [name-generator](name-generator.md) OR [haiku-generator](haiku-generator.md)
|
|
157
|
+
**Agents:** [description-parser](resources/description-parser.md) → [name-generator](resources/name-generator.md) OR [haiku-generator](resources/haiku-generator.md)
|
|
158
158
|
|
|
159
159
|
**Orchestration strategy:**
|
|
160
160
|
|
|
@@ -210,14 +210,14 @@ throw new Error('Could not generate valid content after 3 attempts');
|
|
|
210
210
|
- ~60-70% initial rejection rate forces iteration
|
|
211
211
|
|
|
212
212
|
**Agents using this pattern:**
|
|
213
|
-
- [name-generator](name-generator.md) + name-validator
|
|
214
|
-
- [haiku-generator](haiku-generator.md) + haiku-validator
|
|
213
|
+
- [name-generator](resources/name-generator.md) + name-validator
|
|
214
|
+
- [haiku-generator](resources/haiku-generator.md) + haiku-validator
|
|
215
215
|
|
|
216
216
|
### Workflow E: HITL Approval Gate
|
|
217
217
|
|
|
218
218
|
**When:** Decision requires human judgment (compliance, taste, ethics).
|
|
219
219
|
|
|
220
|
-
**Agent:** [human-approval](human-approval.md)
|
|
220
|
+
**Agent:** [human-approval](resources/human-approval.md)
|
|
221
221
|
|
|
222
222
|
**Orchestration strategy:**
|
|
223
223
|
|
|
@@ -504,30 +504,30 @@ Good: "What's your favorite type of music?" → [response] → "Great! Tell me a
|
|
|
504
504
|
- haiku-validator (no agent resource - pure TypeScript logic)
|
|
505
505
|
|
|
506
506
|
### One-Shot LLM Analyzers
|
|
507
|
-
- [Photo Analyzer](photo-analyzer.md) - Vision analysis
|
|
508
|
-
- [Description Parser](description-parser.md) - Text parsing
|
|
509
|
-
- [Name Generator](name-generator.md) - Creative naming
|
|
510
|
-
- [Haiku Generator](haiku-generator.md) - Haiku composition
|
|
507
|
+
- [Photo Analyzer](resources/photo-analyzer.md) - Vision analysis
|
|
508
|
+
- [Description Parser](resources/description-parser.md) - Text parsing
|
|
509
|
+
- [Name Generator](resources/name-generator.md) - Creative naming
|
|
510
|
+
- [Haiku Generator](resources/haiku-generator.md) - Haiku composition
|
|
511
511
|
|
|
512
512
|
### Conversational Assistant
|
|
513
|
-
- [Breed Advisor](breed-advisor.md) - Multi-turn breed selection
|
|
514
|
-
- [Welcome Message](breed-advisor.md#welcome-message)
|
|
515
|
-
- [Music Preference Insight](breed-advisor.md#music-preference-insight)
|
|
516
|
-
- [Factor Definitions](breed-advisor.md#factor-definitions)
|
|
517
|
-
- [Conversation Strategy](breed-advisor.md#conversation-strategy)
|
|
518
|
-
- [Factor Extraction Prompt](breed-advisor.md#factor-extraction-prompt)
|
|
519
|
-
- [Transition Message](breed-advisor.md#transition-message)
|
|
520
|
-
- [Recommendation Presentation](breed-advisor.md#recommendation-presentation-prompt)
|
|
521
|
-
- [Selection Extraction](breed-advisor.md#selection-extraction-prompt)
|
|
522
|
-
- [Conclusion Prompt](breed-advisor.md#conclusion-prompt)
|
|
513
|
+
- [Breed Advisor](resources/breed-advisor.md) - Multi-turn breed selection
|
|
514
|
+
- [Welcome Message](resources/breed-advisor.md#welcome-message)
|
|
515
|
+
- [Music Preference Insight](resources/breed-advisor.md#music-preference-insight)
|
|
516
|
+
- [Factor Definitions](resources/breed-advisor.md#factor-definitions)
|
|
517
|
+
- [Conversation Strategy](resources/breed-advisor.md#conversation-strategy)
|
|
518
|
+
- [Factor Extraction Prompt](resources/breed-advisor.md#factor-extraction-prompt)
|
|
519
|
+
- [Transition Message](resources/breed-advisor.md#transition-message)
|
|
520
|
+
- [Recommendation Presentation](resources/breed-advisor.md#recommendation-presentation-prompt)
|
|
521
|
+
- [Selection Extraction](resources/breed-advisor.md#selection-extraction-prompt)
|
|
522
|
+
- [Conclusion Prompt](resources/breed-advisor.md#conclusion-prompt)
|
|
523
523
|
|
|
524
524
|
### External Event Integrator
|
|
525
|
-
- [Human Approval](human-approval.md) - HITL approval gate
|
|
525
|
+
- [Human Approval](resources/human-approval.md) - HITL approval gate
|
|
526
526
|
|
|
527
527
|
### Related Documentation
|
|
528
|
-
- [Cat Breed Selection Skill](cat-breed-selection.md) - Detailed breed advisor orchestration
|
|
528
|
+
- [Cat Breed Selection Skill](resources/cat-breed-selection.md) - Detailed breed advisor orchestration
|
|
529
529
|
- Package README - Human-facing documentation
|
|
530
|
-
- Package Structure - Technical organization
|
|
530
|
+
- [Package Structure](resources/structure.md) - Technical organization
|
|
531
531
|
|
|
532
532
|
## Success Criteria
|
|
533
533
|
|