agent-skill-kit 3.9.135

package/.agent/skills/ai-artist/SKILL.md

@@ -0,0 +1,186 @@
+---
+name: ai-artist
+description: >-
+  Prompt engineering for AI image generation: Midjourney, DALL-E, Stable Diffusion, Flux.
+  Use when writing image prompts, configuring generation parameters, or optimizing AI art output.
+  NOT for UI design decisions (use design-system) or media file processing (use media-processing).
+category: prompt-engineering
+triggers: ["prompt", "AI prompt", "image generation", "Midjourney", "DALL-E", "Stable Diffusion", "Flux"]
+coordinates_with: ["studio", "media-processing", "context-engineering"]
+success_metrics: ["100% deterministic prompt reproduction"]
+metadata:
+  author: pikakit
+  version: "3.9.134"
+---
+
+# AI Artist — Prompt Engineering
+
+> Deterministic prompt construction for LLMs and image generation models. Same inputs = same output.
+
+---
+
+## Prerequisites
+
+**Required:** None — AI Artist is a knowledge-based skill with no external dependencies.
+
+**Optional:**
+- Target model API access (Claude, GPT, Gemini, Midjourney, DALL-E, SD, Flux)
+- `studio` skill (for design system prompts)
+- `media-processing` skill (for post-processing generated images)
+
+---
+
+## When to Use
+
+| Situation | Reference |
+|-----------|-----------|
+| Structuring LLM prompts | This file — LLM Prompt Pattern |
+| Generating image prompts | `rules/image-prompts.md` |
+| Marketing/copywriting prompts | `rules/domain-marketing.md` |
+| Code generation prompts | `rules/domain-code.md` |
+| Model-specific parameters | `rules/model-syntax.md` |
+| Architecture review, contracts, security | `rules/engineering-spec.md` |
+
+---
+
+## System Boundaries
+
+| Owned by This Skill | NOT Owned |
+|---------------------|-----------|
+| Prompt template construction | API submission to models |
+| Domain-specific prompt patterns | Response quality evaluation |
+| Model parameter syntax | Content safety filtering |
+| Success criteria extraction | Token counting (→ context-engineering) |
+| Prompt versioning structure | Design systems (→ studio) |
+
+**Pure function:** This skill produces text output. Zero network calls, zero file mutations, zero side effects.
+
+---
+
+## Execution Model — 3-Phase Lifecycle
+
+| Phase | Action | Output |
+|-------|--------|--------|
+| **Parse** | Validate domain, template, parameters | Validated input or error |
+| **Compose** | Apply template, inject parameters, format for model | Structured prompt string |
+| **Emit** | Return prompt with metadata and success criteria | Complete output |
+
+All phases execute synchronously. No async pipeline, no queue.
+
+---
+
+## LLM Prompt Pattern
+
+```markdown
+[Role] You are a [expertise] specializing in [domain].
+[Context] [Background, constraints, audience]
+[Task] [Specific action to perform]
+[Format] [Output structure: markdown, JSON, etc.]
+[Constraints] [Word limit, tone, technical level]
+[Examples]
+Good: [Example of desired output]
+Bad: [Example to avoid]
+```
+
+---
+
+## Image Prompt Pattern
+
+```
+[Subject] + [Style] + [Composition] + [Quality] + [Model Parameters]
+```
+
+**Parameter ordering is fixed:** subject → style → composition → quality → model_params.
+
+**Example:**
+```
+Portrait of cyberpunk hacker, neon purple lighting, cinematic close-up,
+volumetric fog, 8k render, artstation quality --ar 16:9 --style raw
+```
+
+| Element | Purpose | Example |
+|---------|---------|---------|
+| Subject | What to generate | "portrait of cyberpunk hacker" |
+| Style | Visual aesthetic | "neon lighting, cinematic" |
+| Composition | Framing | "close-up, shallow depth of field" |
+| Quality | Render markers | "8k, artstation quality" |
+| Parameters | Model-specific | `--ar 16:9 --style raw` |
+
+---
+
+## Supported Models
+
+| Model | Domain | Parameter Reference |
+|-------|--------|---------------------|
+| Claude, GPT, Gemini | Text, Code, Marketing | Core LLM pattern (above) |
+| Midjourney | Image | `rules/model-syntax.md` — `--ar`, `--style`, `--chaos` |
+| DALL-E | Image | `rules/model-syntax.md` — size, quality, style |
+| Stable Diffusion | Image | `rules/model-syntax.md` — steps, cfg, sampler |
+| Flux | Image | `rules/model-syntax.md` — guidance, steps |
+
+Unknown model → generic format (no model-specific parameters injected).
+
+---
+
+## Error Taxonomy
+
+| Code | Recoverable | Trigger |
+|------|-------------|---------|
+| `ERR_INVALID_DOMAIN` | No | Domain not one of: text, image, code, marketing |
+| `ERR_INVALID_TEMPLATE` | No | Template not one of: role-task, subject-style, chain-of-thought, few-shot |
+| `ERR_MISSING_PARAM` | Yes | Required parameter is null or empty |
+| `ERR_UNKNOWN_MODEL` | Yes | Model not recognized; falls back to generic format |
+| `ERR_TEMPLATE_NOT_FOUND` | No | Reference file missing from skill directory |
+| `ERR_PARAM_CONFLICT` | Yes | Contradictory parameters (e.g., format=json + template=subject-style) |
+| `ERR_PARAM_TOO_LONG` | Yes | Parameter exceeds maximum character limit |
+
+**Zero internal retries.** Deterministic output makes retries meaningless for same input.
+
+---
+
+## Anti-Patterns
+
+| ❌ Don't | ✅ Do |
+|---------|-------|
+| "Make it better" | "Increase contrast by 20%" |
+| "Professional but casual" | Choose one tone, specify explicitly |
+| Skip context/constraints | Set role, audience, constraints upfront |
+| Over-prompt with 10+ directives | Focus on 3–5 core requirements |
+| Assume model compatibility | Check `rules/model-syntax.md` for target model |
+
+---
+
+## Troubleshooting
+
+| Problem | Cause | Resolution |
+|---------|-------|------------|
+| Vague output | Missing constraints | Add specific criteria: "under 150 words", "technical audience" |
+| Wrong visual style | Style description too generic | Use style references: "in the style of [artist/work]" |
+| Busy image composition | Too many subjects | Reduce to one primary subject, simplify background |
+| Inconsistent results | No seed parameter | Add `--seed` for Midjourney/SD; not controllable for LLMs |
+| Syntax errors in model params | Wrong model format | Check `rules/model-syntax.md` for correct syntax |
+| Token limit exceeded | Prompt too long | Estimate: ~4 chars/token for English; trim constraints |
+
+## 📑 Content Map
+
+| File | Description | When to Read |
+|------|-------------|--------------|
+| [image-prompts.md](rules/image-prompts.md) | Image generation techniques, styles, composition | Visual AI prompts |
+| [domain-marketing.md](rules/domain-marketing.md) | Marketing copy, AIDA/PAS formulas | Copywriting prompts |
+| [domain-code.md](rules/domain-code.md) | Code generation patterns | Programming prompts |
+| [model-syntax.md](rules/model-syntax.md) | Model-specific parameters | Midjourney, SD, DALL-E, Flux |
+| [engineering-spec.md](rules/engineering-spec.md) | Full engineering spec: contracts, security, scalability | Architecture review, integration |
+
+---
+
+## 🔗 Related
+
+| Item | Type | Purpose |
+|------|------|---------|
+| `studio` | Skill | Design system generation, color palettes |
+| `media-processing` | Skill | Post-processing generated images |
+| `context-engineering` | Skill | Token management, context window planning |
+
+---
+
+⚡ PikaKit v3.9.134

package/.agent/skills/ai-artist/rules/_sections.md

@@ -0,0 +1,30 @@
+# Sections
+
+This file defines all sections, their ordering, impact levels, and descriptions.
+The section ID (in parentheses) is the filename prefix used to group rules.
+
+---
+
+## 1. Domain (domain)
+
+**Impact:** LOW  
+**Description:** Domain patterns and best practices.
+
+## 2. Engineering Specification (engineering)
+
+**Impact:** MEDIUM  
+**Description:** Full engineering specification covering contracts, security, and scalability.
+
+## 3. Image (image)
+
+**Impact:** LOW  
+**Description:** Image patterns and best practices.
+
+## 4. Model (model)
+
+**Impact:** LOW  
+**Description:** Model patterns and best practices.
+
+---
+
+⚡ PikaKit v3.9.134

package/.agent/skills/ai-artist/rules/_template.md

@@ -0,0 +1,32 @@
+---
+title: Rule Title Here
+impact: MEDIUM
+impactDescription: Optional description of impact (e.g., "20-50% improvement")
+tags: tag1, tag2
+---
+
+## Rule Title Here
+
+**Impact: MEDIUM (optional impact description)**
+
+Brief explanation of the rule and why it matters. This should be clear and concise, explaining the performance implications.
+
+**Incorrect (description of what's wrong):**
+
+```typescript
+// Bad code example here
+const bad = example()
+```
+
+**Correct (description of what's right):**
+
+```typescript
+// Good code example here
+const good = example()
+```
+
+Reference: [Link to documentation or resource](https://example.com)
+
+---
+
+⚡ PikaKit v3.9.134

package/.agent/skills/ai-artist/rules/domain-code.md

@@ -0,0 +1,118 @@
+---
+name: domain-code
+description: Code generation prompt patterns — function gen, code review, refactoring, debugging, API design
+title: "Code Generation Prompt Patterns"
+impact: MEDIUM
+impactDescription: "Moderate improvement to quality or maintainability"
+tags: domain, code
+---
+
+# Code Generation Prompt Patterns
+
+> Templates for generating code with AI.
+
+---
+
+## Function Generation
+
+```markdown
+[Role] You are a senior [language] developer.
+[Context] Project uses [framework], follows [style guide].
+[Task] Write a function that [specific behavior].
+[Format] TypeScript with JSDoc, include error handling.
+
+[Constraints]
+- Pure function (no side effects)
+- Handle edge cases: null, empty, invalid input
+- Include type definitions
+- Add unit test examples
+
+[Example signature]
+function processPayment(amount: number, currency: string): PaymentResult
+```
+
+---
+
+## Code Review
+
+```markdown
+[Role] You are a code reviewer with security focus.
+[Context] PR for [feature], affects [components].
+[Task] Review this code for issues.
+[Format] Categorized feedback: Critical, Important, Suggestion.
+
+[Check for]
+- Security vulnerabilities (OWASP Top 10)
+- Performance issues (N+1, memory leaks)
+- Code style violations
+- Missing error handling
+- Test coverage gaps
+```
+
+---
+
+## Refactoring
+
+```markdown
+[Role] You are a software architect.
+[Context] Legacy code in [language], needs modernization.
+[Task] Refactor this code to [goal: reduce complexity, improve performance].
+[Format] Show before/after with explanation.
+
+[Constraints]
+- Maintain backward compatibility
+- Improve readability
+- Add types if missing
+- Keep same public API
+```
+
+---
+
+## Debugging
+
+```markdown
+[Role] You are a debugging expert.
+[Context] Error: [error message], Environment: [prod/dev], Stack: [tech stack]
+[Task] Analyze this error and suggest fixes.
+[Format] 
+1. Root cause analysis
+2. Immediate fix
+3. Long-term solution
+4. Prevention strategy
+
+[Provide]
+- Error logs
+- Relevant code
+- Steps to reproduce
+```
+
+---
+
+## API Design
+
+```markdown
+[Role] You are an API architect.
+[Context] Building [REST/GraphQL] API for [domain].
+[Task] Design endpoints for [feature].
+[Format] OpenAPI spec with examples.
+
+[Include]
+- Request/response schemas
+- Error codes and messages
+- Rate limiting considerations
+- Authentication requirements
+```
+
+---
+
+## 🔗 Related
+
+| File | When to Read |
+|------|-------------|
+| [domain-marketing.md](domain-marketing.md) | Marketing copy prompt patterns |
+| [model-syntax.md](model-syntax.md) | Model-specific parameters |
+| [../SKILL.md](../SKILL.md) | LLM prompt pattern and anti-patterns |
+
+---
+
+⚡ PikaKit v3.9.134

package/.agent/skills/ai-artist/rules/domain-marketing.md

@@ -0,0 +1,105 @@
+---
+name: domain-marketing
+description: Marketing copy prompt patterns — headlines (AIDA/PAS/4U), product descriptions, email sequences, ad copy, social media
+title: "Marketing Prompt Patterns"
+impact: MEDIUM
+impactDescription: "Moderate improvement to quality or maintainability"
+tags: domain, marketing
+---
+
+# Marketing Prompt Patterns
+
+> Templates for generating marketing copy with AI.
+
+---
+
+## Headlines
+
+```markdown
+[Role] You are a conversion-focused copywriter.
+[Context] Product: [product], Audience: [target], Goal: [objective]
+[Task] Write 5 headline variations using proven formulas.
+[Format] Each headline with formula name in parentheses.
+
+[Formulas]
+- AIDA: Attention, Interest, Desire, Action
+- PAS: Problem, Agitate, Solution
+- 4U: Useful, Urgent, Unique, Ultra-specific
+```
+
+---
+
+## Product Descriptions
+
+```markdown
+[Role] You are a persuasive product copywriter.
+[Context] Product: [name], Price: [range], Audience: [demographic]
+[Task] Write a [length] product description.
+[Format] Structure: Hook, 3 benefits with emotional triggers, CTA.
+
+[Example]
+Good: "Silence the chaos. ProSound X500 delivers studio-grade quiet so you focus on what matters."
+Bad: "These headphones have good noise cancellation features."
+```
+
+---
+
+## Email Sequences
+
+```markdown
+[Role] You are an email marketing specialist.
+[Context] Product: [name], Sequence: [welcome/nurture/sales]
+[Task] Write a [N]-email sequence for [goal].
+[Format] For each email: Subject line, Preview text, Body (150 words max), CTA.
+
+[Constraints]
+- Subject lines under 50 characters
+- One clear CTA per email
+- Progressive disclosure of value
+```
+
+---
+
+## Ad Copy
+
+```markdown
+[Role] You are a performance marketing copywriter.
+[Context] Platform: [FB/Google/LinkedIn], Objective: [awareness/conversion]
+[Task] Write [N] ad variations for A/B testing.
+[Format] Headline (30 chars), Description (90 chars), CTA.
+
+[Guidelines]
+- Lead with benefit, not feature
+- Include social proof if available
+- Use power words: free, new, proven, guaranteed
+```
+
+---
+
+## Social Media
+
+```markdown
+[Role] You are a social media content creator.
+[Context] Brand: [tone], Platform: [platform], Goal: [engagement/traffic]
+[Task] Write [N] post variations for [topic].
+[Format] Post text, Hashtags (5 max), Best posting time.
+
+[Platform-specific]
+- Twitter: Under 280 chars, conversational
+- LinkedIn: Professional, 1300 chars max
+- Instagram: Story-driven, emoji-friendly
+```
+
+---
+
+## 🔗 Related
+
+| File | When to Read |
+|------|-------------|
+| [domain-code.md](domain-code.md) | Code generation prompt patterns |
+| [image-prompts.md](image-prompts.md) | Visual prompts for marketing assets |
+| [../SKILL.md](../SKILL.md) | LLM prompt pattern and anti-patterns |
+
+---
+
+⚡ PikaKit v3.9.134