cokit-cli 1.0.1 → 1.0.3

package/skills/ck-ai-artist/references/advanced-techniques.md

@@ -0,0 +1,184 @@
+# Advanced Prompt Engineering
+
+## Prompt Optimization
+
+### DSPy Framework
+Automatic prompt optimization through:
+1. Define task with input/output signatures
+2. Compile with optimizer (BootstrapFewShot, MIPRO)
+3. Model learns optimal prompting strategy
+4. Export optimized prompts for production
+
+### Meta-Prompting
+```
+You are a prompt engineer. Create 5 variations for [task]:
+1. Direct instruction approach
+2. Role-based approach
+3. Few-shot example approach
+4. Chain of thought approach
+5. Constraint-focused approach
+
+Evaluate each, select best.
+```
+
+### Self-Refinement Loop
+```
+Generate: [Initial response]
+Critique: "What's wrong? Score 1-10."
+Refine: "Fix issues, improve score."
+Repeat until score ≥ 8.
+```
+
+## Prompt Chaining
+
+### Sequential Chain
+```
+Chain 1: [Input] → Extract key points
+Chain 2: Key points → Create outline
+Chain 3: Outline → Write draft
+Chain 4: Draft → Edit and polish
+```
+
+### Parallel Chain
+Run independent subtasks simultaneously, merge results.
+
+### Conditional Chain
+```
+If [condition A]: Execute prompt variant 1
+If [condition B]: Execute prompt variant 2
+Else: Execute default prompt
+```
+
+### Loop Pattern
+```
+While not [success condition]:
+    Generate attempt
+    Evaluate against criteria
+    If pass: break
+    Else: refine with feedback
+```
+
+## Evaluation Methods
+
+### LLM-as-Judge
+```
+Rate this [output] on:
+1. Accuracy (1-10)
+2. Completeness (1-10)
+3. Clarity (1-10)
+4. Relevance (1-10)
+
+Provide reasoning for each score.
+Final: Pass/Fail threshold = 7 average.
+```
+
+### A/B Testing Protocol
+1. Single variable per test
+2. 20+ samples minimum
+3. Score on defined criteria
+4. Statistical significance check (p < 0.05)
+5. Document winner, roll out
+
+### Regression Testing
+- Maintain test set of critical examples
+- Run before deploying prompt changes
+- Compare scores to baseline
+- Block deployment if regression detected
+
+## Agent Prompting
+
+### Tool Use Design
+```
+You have access to these tools:
+- search(query): Search the web
+- calculate(expression): Math operations
+- code(language, code): Execute code
+
+To use: <tool_name>arguments</tool_name>
+Wait for result before continuing.
+```
+
+### Planning Prompt
+```
+Task: [Complex goal]
+
+Before acting:
+1. Break into subtasks
+2. Identify dependencies
+3. Plan execution order
+4. Note potential blockers
+
+Then execute step by step.
+```
+
+### Reflection Pattern
+```
+After each step:
+- What worked?
+- What didn't?
+- Adjust approach for next step.
+```
+
+## Parameter Tuning
+
+| Parameter | Low | High | Use Case |
+|-----------|-----|------|----------|
+| Temperature | 0.0-0.3 | 0.7-1.0 | Factual vs Creative |
+| Top-P | 0.8 | 0.95 | Focused vs Diverse |
+| Top-K | 10 | 100 | Conservative vs Exploratory |
+
+**Rule**: Tune temperature first. Only adjust top-p if needed. Never both at once.
+
+## Safety Patterns
+
+### Output Filtering
+```
+Before responding, check:
+- No PII exposure
+- No harmful content
+- No policy violations
+- Aligned with guidelines
+
+If any fail: "I can't help with that."
+```
+
+### Jailbreak Prevention
+- Clear system boundaries upfront
+- Repeat constraints at end
+- "Ignore previous" pattern detection
+- Role-lock: "You are ONLY [role], never anything else"
+
+### Confidence Calibration
+```
+For each claim, provide:
+- Confidence: High/Medium/Low
+- Source: [citation if available]
+- Caveat: [limitations]
+```
+
+## Production Patterns
+
+### Version Control
+- Git for prompt files
+- Semantic versioning (1.0.0, 1.1.0)
+- Changelog per version
+- Rollback capability
+
+### Caching
+- Cache common queries
+- TTL based on content freshness
+- Invalidate on prompt update
+
+### Fallbacks
+```
+Try: Primary prompt
+If fail: Simplified fallback prompt
+If still fail: Human escalation
+Log all failures for analysis.
+```
+
+### Cost Optimization
+- Shorter prompts = fewer tokens
+- Remove redundant examples
+- Use smaller model for simple tasks
+- Batch similar requests

package/skills/ck-ai-artist/references/domain-code.md

@@ -0,0 +1,66 @@
+# Code Generation Patterns
+
+## Function Implementation
+```
+Write a [language] function:
+- Input: [params with types]
+- Output: [return type]
+- Behavior: [logic]
+
+Requirements:
+- Edge cases: [list]
+- Error handling: [approach]
+- Performance: O([complexity])
+```
+
+## Code Review
+```
+Review for:
+1. Bugs/logic errors
+2. Security vulnerabilities
+3. Performance issues
+4. Style violations
+5. Missing edge cases
+
+Format: Issue, line number, severity, fix.
+```
+
+## Refactoring
+```
+Refactor to:
+- [Improvement goal]
+- Maintain backward compatibility
+- Keep public API
+- Add comments for complex logic
+Show before/after.
+```
+
+## Debugging
+```
+<error>[Error message/behavior]</error>
+<code>[Relevant code]</code>
+<context>[When it occurs]</context>
+
+Analyze:
+1. Root cause
+2. Why it happens
+3. Fix with explanation
+4. Prevention strategy
+```
+
+## Test Generation
+```
+Generate tests for [function/class]:
+- Framework: [jest/pytest/etc]
+- Coverage: happy path, edge cases, errors
+- Include: setup, assertion, cleanup
+- Mock: [external dependencies]
+```
+
+## Documentation
+```
+Document this [function/class/API]:
+- Format: [JSDoc/docstring/OpenAPI]
+- Include: description, params, returns, examples
+- Note: edge cases, errors, deprecations
+```

package/skills/ck-ai-artist/references/domain-data.md

@@ -0,0 +1,72 @@
+# Data & Analysis Patterns
+
+## Structured Extraction
+```
+Extract from text:
+<text>[content]</text>
+
+Return JSON:
+{
+  "field1": "value or null",
+  "field2": ["array"]
+}
+
+Rules:
+- Exact matches only
+- Confidence score if uncertain
+- null for missing
+```
+
+## Document Analysis
+```
+Analyze [document type]:
+1. Summary (2-3 sentences)
+2. Key entities (people, orgs, dates)
+3. Main topics (ranked)
+4. Sentiment: positive/neutral/negative
+5. Action items
+```
+
+## Comparison
+```
+Compare [A] and [B]:
+| Criterion | A | B |
+|-----------|---|---|
+| [Factor 1] | | |
+| [Factor 2] | | |
+
+Recommendation: [choice] for [use case]
+```
+
+## Problem Solving
+```
+Problem: [description]
+
+Analyze:
+1. Root cause (5 whys)
+2. Contributing factors
+3. Options (pros/cons)
+4. Recommendation
+5. Implementation steps
+6. Risk mitigation
+```
+
+## Data Transformation
+```
+Transform data:
+- Input format: [CSV/JSON/etc]
+- Output format: [target]
+- Rules: [mapping logic]
+- Validation: [constraints]
+
+Handle: missing values, type mismatches.
+```
+
+## Summarization
+```
+Summarize [content]:
+- Length: [sentences/words]
+- Focus: [key themes]
+- Audience: [technical/general]
+- Preserve: [critical details]
+```

package/skills/ck-ai-artist/references/domain-marketing.md

@@ -0,0 +1,66 @@
+# Marketing Copy Patterns
+
+## Headlines
+```
+Write 5 headline variations for [product].
+Frameworks:
+1. How to [benefit]
+2. [Number] ways to [solve problem]
+3. The secret to [outcome]
+4. Why [audience] love [product]
+5. [Timeframe] to [transformation]
+```
+
+## Product Descriptions
+```
+<product>[Name, features]</product>
+<audience>[Demographics, pain points]</audience>
+
+Write description that:
+- Opens with benefit (not feature)
+- Addresses [main objection]
+- Social proof placeholder
+- Clear CTA
+- Tone: [brand voice]
+- Length: [word count]
+```
+
+## Email Subject Lines
+```
+Generate 10 subject lines for [campaign].
+Mix approaches:
+- Curiosity gap
+- Urgency/scarcity
+- Personalization
+- Question format
+- Number/list
+Under 50 chars. Test 2-3 with emojis.
+```
+
+## Ad Copy
+```
+Platform: [Google/Meta/LinkedIn]
+Objective: [awareness/conversion]
+Character limit: [limit]
+
+Create [N] variations with:
+- Hook (first 5 words critical)
+- Value proposition
+- Social proof element
+- CTA matching platform norms
+```
+
+## Landing Pages
+```
+<offer>[Product/service]</offer>
+<goal>[signup/purchase/download]</goal>
+
+Write sections:
+1. Hero headline + subhead
+2. Problem agitation
+3. Solution introduction
+4. 3-5 benefit bullets
+5. Social proof
+6. CTA with urgency
+7. FAQ (3 objections)
+```

package/skills/ck-ai-artist/references/domain-patterns.md

@@ -0,0 +1,33 @@
+# Domain-Specific Prompt Patterns
+
+Quick reference index. Load specific domain file for detailed patterns.
+
+## Domains
+
+| Domain | File | Use Cases |
+|--------|------|-----------|
+| Marketing | `domain-marketing.md` | Headlines, product copy, emails, ads |
+| Code | `domain-code.md` | Functions, review, refactoring, debugging |
+| Writing | `domain-writing.md` | Stories, characters, dialogue, editing |
+| Data | `domain-data.md` | Extraction, analysis, comparison, reasoning |
+
+## Universal Pattern
+
+All domain prompts follow:
+```
+<context>
+[Domain-specific background]
+</context>
+
+<task>
+[Specific action]
+</task>
+
+<constraints>
+[Quality criteria, format, length, tone]
+</constraints>
+
+<output>
+[Expected structure]
+</output>
+```

package/skills/ck-ai-artist/references/domain-writing.md

@@ -0,0 +1,68 @@
+# Creative Writing Patterns
+
+## Story Outline
+```
+Create [length] story outline:
+- Genre: [genre]
+- Protagonist: [brief]
+- Conflict: [type]
+- Setting: [time/place]
+
+Structure:
+1. Hook/Opening
+2. Inciting incident
+3. Rising action (3 beats)
+4. Climax
+5. Resolution
+```
+
+## Character Voice
+```
+Write as [character]:
+- Background: [history]
+- Speech: [patterns, vocab]
+- Emotion: [current state]
+- Goal: [scene objective]
+
+Maintain voice consistency.
+```
+
+## Dialogue
+```
+Write dialogue between [A] and [B]:
+- Scene: [context]
+- Tension: [conflict source]
+- Subtext: [what's unsaid]
+
+Each character distinct voice. Show don't tell.
+```
+
+## Scene Description
+```
+Describe [scene]:
+- POV: [character/omniscient]
+- Focus: [sensory details]
+- Mood: [atmosphere]
+- Pacing: [fast/slow/measured]
+
+Use active verbs, concrete details.
+```
+
+## Editing Pass
+```
+Edit this [content type]:
+Focus: [clarity/flow/voice/grammar]
+Preserve: [author's style]
+Flag: [major issues only]
+
+Provide tracked changes with rationale.
+```
+
+## Genre Adaptation
+```
+Rewrite [content] as [genre]:
+- Keep: core plot/message
+- Add: genre conventions
+- Tone: [genre-appropriate]
+- Tropes: [use/subvert specific tropes]
+```

package/skills/ck-ai-artist/references/image-prompting.md

@@ -0,0 +1,141 @@
+# Image Generation Prompting
+
+## Universal Structure
+```
+[Subject + Details] [Action/Pose] [Setting/Environment]
+[Style/Medium] [Artist/Movement Reference]
+[Lighting] [Camera/Lens] [Composition]
+[Quality Modifiers] [Aspect Ratio]
+```
+
+## Platform Reference
+
+### Midjourney v6.1
+```
+[prompt] --ar 16:9 --style raw --v 6.1
+```
+
+| Parameter | Values | Effect |
+|-----------|--------|--------|
+| `--ar` | 1:1, 16:9, 9:16, 4:3, 3:2, 21:9 | Aspect ratio |
+| `--style` | raw, default | raw=photorealistic |
+| `--stylize` | 0-1000 | Artistic interpretation (0=literal) |
+| `--chaos` | 0-100 | Variation between outputs |
+| `--weird` | 0-3000 | Unusual/experimental elements |
+| `--quality` | .25, .5, 1, 2 | Detail level (cost) |
+| `--seed` | number | Reproducibility |
+| `--no` | [term] | Negative prompt inline |
+| `--tile` | - | Seamless patterns |
+
+**Multi-prompt weighting**: `cat::2 dog::1` (cat 2x stronger)
+**Describe**: Upload image → get prompt suggestions
+**Blend**: `/blend` to merge 2-5 images
+
+### DALL-E 3
+- Natural language only, no parameters
+- Be descriptive, not keyword-heavy
+- Specify: "HD quality" or "vivid style" in prompt
+- Text rendering: Describe font, placement, content explicitly
+- Avoid: Lists of keywords, technical jargon
+
+### Stable Diffusion / SDXL / Flux
+```
+(important term:1.3), normal term, (less important:0.8)
+Negative prompt: ugly, blurry, deformed, watermark
+```
+
+| Feature | Syntax |
+|---------|--------|
+| Weight up | `(word:1.2)` to `(word:1.5)` |
+| Weight down | `(word:0.5)` to `(word:0.8)` |
+| LoRA | `<lora:model_name:0.8>` |
+| Embedding | `embedding:name` |
+| Blend | `[cat|dog]` alternating |
+
+**CFG Scale**: 7-12 typical (higher=more prompt adherence)
+**Samplers**: DPM++ 2M Karras (quality), Euler a (speed)
+
+### Nano Banana (Gemini)
+```
+[Narrative description, not keywords]
+Captured with 85mm lens, soft bokeh, natural lighting
+```
+
+**Key features**:
+- 32K token context (complex prompts OK)
+- Narrative paragraphs > keyword lists
+- Hex colors for precision: `#9F2B68`
+- Text rendering: Describe font, placement explicitly
+- Multi-image: Up to 14 reference images
+- Search grounding: Real-time data (weather, events)
+- Thinking mode: Complex composition reasoning
+
+**Aspect ratios**: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
+**Resolution**: 1K, 2K, 4K (use uppercase K)
+
+**Best practices**:
+- ALL CAPS for critical requirements
+- Markdown lists for multiple rules
+- "NEVER include..." for negative constraints
+- Photography terms anchor quality
+
+### Imagen 4 / Veo 3.1
+- Natural language, descriptive
+- Aspect ratio in text: "16:9 landscape format"
+- Veo: Cinematography keywords most powerful
+- Camera movements: pan, tilt, dolly, crane, tracking
+- Scene transitions: cut, fade, dissolve
+
+## Style Keywords
+
+### Art Movements
+photorealistic, hyperrealistic, impressionist, expressionist,
+surrealist, art nouveau, art deco, pop art, cyberpunk, steampunk,
+solarpunk, vaporwave, synthwave, brutalist, minimalist
+
+### Media Types
+oil painting, watercolor, digital art, 3D render, vector art,
+pencil sketch, ink drawing, pastel, charcoal, gouache, fresco
+
+### Photography Styles
+portrait, landscape, macro, street, documentary, fashion,
+editorial, product, architectural, aerial, underwater
+
+## Lighting Vocabulary
+
+| Term | Effect |
+|------|--------|
+| Golden hour | Warm, soft, directional |
+| Blue hour | Cool, moody, twilight |
+| Rembrandt | Triangle on cheek, dramatic |
+| Butterfly | Shadow under nose, glamorous |
+| Split | Half face lit, mysterious |
+| Rim/back | Edge highlight, separation |
+| Volumetric | Light rays visible |
+| Neon glow | Colorful, cyberpunk |
+
+## Camera/Lens Terms
+- 50mm (standard), 85mm (portrait), 35mm (wide)
+- Telephoto (compressed), Macro (close-up), Fisheye (distorted)
+- Shallow DOF, Deep DOF, Bokeh
+- Low angle, High angle, Dutch angle, Bird's eye, Worm's eye
+
+## Composition Keywords
+rule of thirds, golden ratio, centered, symmetrical,
+leading lines, framing, negative space, filling frame,
+foreground interest, layered depth
+
+## Negative Prompts (SD/Flux)
+```
+ugly, deformed, blurry, low quality, bad anatomy,
+extra limbs, missing limbs, disfigured, watermark,
+text, signature, cropped, out of frame, duplicate,
+poorly drawn, bad proportions, gross proportions
+```
+
+## Iterative Workflow
+1. Start: Subject + style + quality modifier
+2. Add: Lighting + composition + camera
+3. Test: Generate 4 variations
+4. Refine: Adjust weights, add negatives
+5. Upscale: Select winner, increase resolution