takomi 2.0.4

package/assets/.agent/skills/programmatic-seo/references/playbooks.md

@@ -0,0 +1,293 @@
+# The 12 Programmatic SEO Playbooks
+
+Beyond mixing and matching data point permutations, these are the proven playbooks for programmatic SEO.
+
+## 1. Templates
+
+**Pattern**: "[Type] template" or "free [type] template"
+**Example searches**: "resume template", "invoice template", "pitch deck template"
+
+**What it is**: Downloadable or interactive templates users can use directly.
+
+**Why it works**:
+- High intent—people need it now
+- Shareable/linkable assets
+- Natural for product-led companies
+
+**Value requirements**:
+- Actually usable templates (not just previews)
+- Multiple variations per type
+- Quality comparable to paid options
+- Easy download/use flow
+
+**URL structure**: `/templates/[type]/` or `/templates/[category]/[type]/`
+
+---
+
+## 2. Curation
+
+**Pattern**: "best [category]" or "top [number] [things]"
+**Example searches**: "best website builders", "top 10 crm software", "best free design tools"
+
+**What it is**: Curated lists ranking or recommending options in a category.
+
+**Why it works**:
+- Comparison shoppers searching for guidance
+- High commercial intent
+- Evergreen with updates
+
+**Value requirements**:
+- Genuine evaluation criteria
+- Real testing or expertise
+- Regular updates (date visible)
+- Not just affiliate-driven rankings
+
+**URL structure**: `/best/[category]/` or `/[category]/best/`
+
+---
+
+## 3. Conversions
+
+**Pattern**: "[X] to [Y]" or "[amount] [unit] in [unit]"
+**Example searches**: "$10 USD to GBP", "100 kg to lbs", "pdf to word"
+
+**What it is**: Tools or pages that convert between formats, units, or currencies.
+
+**Why it works**:
+- Instant utility
+- Extremely high search volume
+- Repeat usage potential
+
+**Value requirements**:
+- Accurate, real-time data
+- Fast, functional tool
+- Related conversions suggested
+- Mobile-friendly interface
+
+**URL structure**: `/convert/[from]-to-[to]/` or `/[from]-to-[to]-converter/`
+
+---
+
+## 4. Comparisons
+
+**Pattern**: "[X] vs [Y]" or "[X] alternative"
+**Example searches**: "webflow vs wordpress", "notion vs coda", "figma alternatives"
+
+**What it is**: Head-to-head comparisons between products, tools, or options.
+
+**Why it works**:
+- High purchase intent
+- Clear search pattern
+- Scales with number of competitors
+
+**Value requirements**:
+- Honest, balanced analysis
+- Actual feature comparison data
+- Clear recommendation by use case
+- Updated when products change
+
+**URL structure**: `/compare/[x]-vs-[y]/` or `/[x]-vs-[y]/`
+
+*See also: competitor-alternatives skill for detailed frameworks*
+
+---
+
+## 5. Examples
+
+**Pattern**: "[type] examples" or "[category] inspiration"
+**Example searches**: "saas landing page examples", "email subject line examples", "portfolio website examples"
+
+**What it is**: Galleries or collections of real-world examples for inspiration.
+
+**Why it works**:
+- Research phase traffic
+- Highly shareable
+- Natural for design/creative tools
+
+**Value requirements**:
+- Real, high-quality examples
+- Screenshots or embeds
+- Categorization/filtering
+- Analysis of why they work
+
+**URL structure**: `/examples/[type]/` or `/[type]-examples/`
+
+---
+
+## 6. Locations
+
+**Pattern**: "[service/thing] in [location]"
+**Example searches**: "coworking spaces in san diego", "dentists in austin", "best restaurants in brooklyn"
+
+**What it is**: Location-specific pages for services, businesses, or information.
+
+**Why it works**:
+- Local intent is massive
+- Scales with geography
+- Natural for marketplaces/directories
+
+**Value requirements**:
+- Actual local data (not just city name swapped)
+- Local providers/options listed
+- Location-specific insights (pricing, regulations)
+- Map integration helpful
+
+**URL structure**: `/[service]/[city]/` or `/locations/[city]/[service]/`
+
+---
+
+## 7. Personas
+
+**Pattern**: "[product] for [audience]" or "[solution] for [role/industry]"
+**Example searches**: "payroll software for agencies", "crm for real estate", "project management for freelancers"
+
+**What it is**: Tailored landing pages addressing specific audience segments.
+
+**Why it works**:
+- Speaks directly to searcher's context
+- Higher conversion than generic pages
+- Scales with personas
+
+**Value requirements**:
+- Genuine persona-specific content
+- Relevant features highlighted
+- Testimonials from that segment
+- Use cases specific to audience
+
+**URL structure**: `/for/[persona]/` or `/solutions/[industry]/`
+
+---
+
+## 8. Integrations
+
+**Pattern**: "[your product] [other product] integration" or "[product] + [product]"
+**Example searches**: "slack asana integration", "zapier airtable", "hubspot salesforce sync"
+
+**What it is**: Pages explaining how your product works with other tools.
+
+**Why it works**:
+- Captures users of other products
+- High intent (they want the solution)
+- Scales with integration ecosystem
+
+**Value requirements**:
+- Real integration details
+- Setup instructions
+- Use cases for the combination
+- Working integration (not vaporware)
+
+**URL structure**: `/integrations/[product]/` or `/connect/[product]/`
+
+---
+
+## 9. Glossary
+
+**Pattern**: "what is [term]" or "[term] definition" or "[term] meaning"
+**Example searches**: "what is pSEO", "api definition", "what does crm stand for"
+
+**What it is**: Educational definitions of industry terms and concepts.
+
+**Why it works**:
+- Top-of-funnel awareness
+- Establishes expertise
+- Natural internal linking opportunities
+
+**Value requirements**:
+- Clear, accurate definitions
+- Examples and context
+- Related terms linked
+- More depth than a dictionary
+
+**URL structure**: `/glossary/[term]/` or `/learn/[term]/`
+
+---
+
+## 10. Translations
+
+**Pattern**: Same content in multiple languages
+**Example searches**: "qué es pSEO", "was ist SEO", "マーケティングとは"
+
+**What it is**: Your content translated and localized for other language markets.
+
+**Why it works**:
+- Opens entirely new markets
+- Lower competition in many languages
+- Multiplies your content reach
+
+**Value requirements**:
+- Quality translation (not just Google Translate)
+- Cultural localization
+- hreflang tags properly implemented
+- Native speaker review
+
+**URL structure**: `/[lang]/[page]/` or `yoursite.com/es/`, `/de/`, etc.
+
+---
+
+## 11. Directory
+
+**Pattern**: "[category] tools" or "[type] software" or "[category] companies"
+**Example searches**: "ai copywriting tools", "email marketing software", "crm companies"
+
+**What it is**: Comprehensive directories listing options in a category.
+
+**Why it works**:
+- Research phase capture
+- Link building magnet
+- Natural for aggregators/reviewers
+
+**Value requirements**:
+- Comprehensive coverage
+- Useful filtering/sorting
+- Details per listing (not just names)
+- Regular updates
+
+**URL structure**: `/directory/[category]/` or `/[category]-directory/`
+
+---
+
+## 12. Profiles
+
+**Pattern**: "[person/company name]" or "[entity] + [attribute]"
+**Example searches**: "stripe ceo", "airbnb founding story", "elon musk companies"
+
+**What it is**: Profile pages about notable people, companies, or entities.
+
+**Why it works**:
+- Informational intent traffic
+- Builds topical authority
+- Natural for B2B, news, research
+
+**Value requirements**:
+- Accurate, sourced information
+- Regularly updated
+- Unique insights or aggregation
+- Not just Wikipedia rehash
+
+**URL structure**: `/people/[name]/` or `/companies/[name]/`
+
+---
+
+## Choosing Your Playbook
+
+### Match to Your Assets
+
+| If you have... | Consider... |
+|----------------|-------------|
+| Proprietary data | Stats, Directories, Profiles |
+| Product with integrations | Integrations |
+| Design/creative product | Templates, Examples |
+| Multi-segment audience | Personas |
+| Local presence | Locations |
+| Tool or utility product | Conversions |
+| Content/expertise | Glossary, Curation |
+| International potential | Translations |
+| Competitor landscape | Comparisons |
+
+### Combine Playbooks
+
+You can layer multiple playbooks:
+- **Locations + Personas**: "Marketing agencies for startups in Austin"
+- **Curation + Locations**: "Best coworking spaces in San Diego"
+- **Integrations + Personas**: "Slack for sales teams"
+- **Glossary + Translations**: Multi-language educational content

package/assets/.agent/skills/prompt-engineering/SKILL.md

@@ -0,0 +1,342 @@
+---
+name: prompt-engineering
+description: |
+  Master prompt engineering for AI models: LLMs, image generators, video models.
+  Techniques: chain-of-thought, few-shot, system prompts, negative prompts.
+  Models: Claude, GPT-4, Gemini, FLUX, Veo, Stable Diffusion prompting.
+  Use for: better AI outputs, consistent results, complex tasks, optimization.
+  Triggers: prompt engineering, how to prompt, better prompts, prompt tips,
+  prompting guide, llm prompting, image prompt, ai prompting, prompt optimization,
+  prompt template, prompt structure, effective prompts, prompt techniques
+allowed-tools: Bash(infsh *)
+---
+
+# Prompt Engineering Guide
+
+Master prompt engineering for AI models via [inference.sh](https://inference.sh) CLI.
+
+## Quick Start
+
+```bash
+curl -fsSL https://cli.inference.sh | sh && infsh login
+
+# Well-structured LLM prompt
+infsh app run openrouter/claude-sonnet-45 --input '{
+  "prompt": "You are a senior software engineer. Review this code for security vulnerabilities:\n\n```python\nuser_input = request.args.get(\"query\")\nresult = db.execute(f\"SELECT * FROM users WHERE name = {user_input}\")\n```\n\nProvide specific issues and fixes."
+}'
+```
+
+## LLM Prompting
+
+### Basic Structure
+
+```
+[Role/Context] + [Task] + [Constraints] + [Output Format]
+```
+
+### Role Prompting
+
+```bash
+infsh app run openrouter/claude-sonnet-45 --input '{
+  "prompt": "You are an expert data scientist with 15 years of experience in machine learning. Explain gradient descent to a beginner, using simple analogies."
+}'
+```
+
+### Task Clarity
+
+```bash
+# Bad: vague
+"Help me with my code"
+
+# Good: specific
+"Debug this Python function that should return the sum of even numbers from a list, but returns 0 for all inputs:
+
+def sum_evens(numbers):
+    total = 0
+    for n in numbers:
+        if n % 2 == 0:
+            total += n
+        return total
+
+Identify the bug and provide the corrected code."
+```
+
+### Chain-of-Thought
+
+```bash
+infsh app run openrouter/claude-sonnet-45 --input '{
+  "prompt": "Solve this step by step:\n\nA store sells apples for $2 each and oranges for $3 each. If someone buys 5 fruits and spends $12, how many of each fruit did they buy?\n\nThink through this step by step before giving the final answer."
+}'
+```
+
+### Few-Shot Examples
+
+```bash
+infsh app run openrouter/claude-sonnet-45 --input '{
+  "prompt": "Convert these sentences to formal business English:\n\nExample 1:\nInput: gonna send u the report tmrw\nOutput: I will send you the report tomorrow.\n\nExample 2:\nInput: cant make the meeting, something came up\nOutput: I apologize, but I will be unable to attend the meeting due to an unforeseen circumstance.\n\nNow convert:\nInput: hey can we push the deadline back a bit?"
+}'
+```
+
+### Output Format Specification
+
+```bash
+infsh app run openrouter/claude-sonnet-45 --input '{
+  "prompt": "Analyze the sentiment of these customer reviews. Return a JSON array with objects containing \"text\", \"sentiment\" (positive/negative/neutral), and \"confidence\" (0-1).\n\nReviews:\n1. \"Great product, fast shipping!\"\n2. \"Meh, its okay I guess\"\n3. \"Worst purchase ever, total waste of money\"\n\nReturn only valid JSON, no explanation."
+}'
+```
+
+### Constraint Setting
+
+```bash
+infsh app run openrouter/claude-sonnet-45 --input '{
+  "prompt": "Summarize this article in exactly 3 bullet points. Each bullet must be under 20 words. Focus only on actionable insights, not background information.\n\n[article text]"
+}'
+```
+
+## Image Generation Prompting
+
+### Basic Structure
+
+```
+[Subject] + [Style] + [Composition] + [Lighting] + [Technical]
+```
+
+### Subject Description
+
+```bash
+# Bad: vague
+"a cat"
+
+# Good: specific
+infsh app run falai/flux-dev --input '{
+  "prompt": "A fluffy orange tabby cat with green eyes, sitting on a vintage leather armchair"
+}'
+```
+
+### Style Keywords
+
+```bash
+infsh app run falai/flux-dev --input '{
+  "prompt": "Portrait photograph of a woman, shot on Kodak Portra 400 film, soft natural lighting, shallow depth of field, nostalgic mood, analog photography aesthetic"
+}'
+```
+
+### Composition Control
+
+```bash
+infsh app run falai/flux-dev --input '{
+  "prompt": "Wide establishing shot of a cyberpunk city skyline at night, rule of thirds composition, neon signs in foreground, towering skyscrapers in background, rain-slicked streets"
+}'
+```
+
+### Quality Keywords
+
+```
+photorealistic, 8K, ultra detailed, sharp focus, professional,
+masterpiece, high quality, best quality, intricate details
+```
+
+### Negative Prompts
+
+```bash
+infsh app run falai/flux-dev --input '{
+  "prompt": "Professional headshot portrait, clean background",
+  "negative_prompt": "blurry, distorted, extra limbs, watermark, text, low quality, cartoon, anime"
+}'
+```
+
+## Video Prompting
+
+### Basic Structure
+
+```
+[Shot Type] + [Subject] + [Action] + [Setting] + [Style]
+```
+
+### Camera Movement
+
+```bash
+infsh app run google/veo-3-1-fast --input '{
+  "prompt": "Slow tracking shot following a woman walking through a sunlit forest, golden hour lighting, shallow depth of field, cinematic, 4K"
+}'
+```
+
+### Action Description
+
+```bash
+infsh app run google/veo-3-1-fast --input '{
+  "prompt": "Close-up of hands kneading bread dough on a wooden surface, flour dust floating in morning light, slow motion, cozy baking aesthetic"
+}'
+```
+
+### Temporal Keywords
+
+```
+slow motion, timelapse, real-time, smooth motion,
+continuous shot, quick cuts, frozen moment
+```
+
+## Advanced Techniques
+
+### System Prompts
+
+```bash
+infsh app run openrouter/claude-sonnet-45 --input '{
+  "system": "You are a helpful coding assistant. Always provide code with comments. If you are unsure about something, say so rather than guessing.",
+  "prompt": "Write a Python function to validate email addresses using regex."
+}'
+```
+
+### Structured Output
+
+```bash
+infsh app run openrouter/claude-sonnet-45 --input '{
+  "prompt": "Extract information from this text and return as JSON:\n\n\"John Smith, CEO of TechCorp, announced yesterday that the company raised $50 million in Series B funding. The round was led by Venture Partners.\"\n\nSchema:\n{\n  \"person\": string,\n  \"title\": string,\n  \"company\": string,\n  \"event\": string,\n  \"amount\": string,\n  \"investor\": string\n}"
+}'
+```
+
+### Iterative Refinement
+
+```bash
+# Start broad
+infsh app run falai/flux-dev --input '{
+  "prompt": "A castle on a hill"
+}'
+
+# Add specifics
+infsh app run falai/flux-dev --input '{
+  "prompt": "A medieval stone castle on a grassy hill"
+}'
+
+# Add style
+infsh app run falai/flux-dev --input '{
+  "prompt": "A medieval stone castle on a grassy hill, dramatic sunset sky, fantasy art style, epic composition"
+}'
+
+# Add technical
+infsh app run falai/flux-dev --input '{
+  "prompt": "A medieval stone castle on a grassy hill, dramatic sunset sky, fantasy art style by Greg Rutkowski, epic composition, 8K, highly detailed"
+}'
+```
+
+### Multi-Turn Reasoning
+
+```bash
+# First: analyze
+infsh app run openrouter/claude-sonnet-45 --input '{
+  "prompt": "Analyze this business problem: Our e-commerce site has a 70% cart abandonment rate. List potential causes."
+}'
+
+# Second: prioritize
+infsh app run openrouter/claude-sonnet-45 --input '{
+  "prompt": "Given these causes of cart abandonment: [previous output], rank them by likely impact and ease of fixing. Format as a priority matrix."
+}'
+
+# Third: action plan
+infsh app run openrouter/claude-sonnet-45 --input '{
+  "prompt": "For the top 3 causes identified, provide specific A/B tests we can run to validate and fix each issue."
+}'
+```
+
+## Model-Specific Tips
+
+### Claude
+
+- Excels at nuanced instructions
+- Responds well to role-playing
+- Good at following complex constraints
+- Prefers explicit output formats
+
+### GPT-4
+
+- Strong at code generation
+- Works well with examples
+- Good structured output
+- Responds to "let's think step by step"
+
+### FLUX
+
+- Detailed subject descriptions
+- Style references work well
+- Lighting keywords important
+- Negative prompts supported
+
+### Veo
+
+- Camera movement keywords
+- Cinematic language works well
+- Action descriptions important
+- Include temporal context
+
+## Common Mistakes
+
+| Mistake | Problem | Fix |
+|---------|---------|-----|
+| Too vague | Unpredictable output | Add specifics |
+| Too long | Model loses focus | Prioritize key info |
+| Conflicting | Confuses model | Remove contradictions |
+| No format | Inconsistent output | Specify format |
+| No examples | Unclear expectations | Add few-shot |
+
+## Prompt Templates
+
+### Code Review
+
+```
+Review this [language] code for:
+1. Bugs and logic errors
+2. Security vulnerabilities
+3. Performance issues
+4. Code style/best practices
+
+Code:
+[code]
+
+For each issue found, provide:
+- Line number
+- Issue description
+- Severity (high/medium/low)
+- Suggested fix
+```
+
+### Content Writing
+
+```
+Write a [content type] about [topic].
+
+Audience: [target audience]
+Tone: [formal/casual/professional]
+Length: [word count]
+Key points to cover:
+1. [point 1]
+2. [point 2]
+3. [point 3]
+
+Include: [specific elements]
+Avoid: [things to exclude]
+```
+
+### Image Generation
+
+```
+[Subject with details], [setting/background], [lighting type],
+[art style or photography style], [composition], [quality keywords]
+```
+
+## Related Skills
+
+```bash
+# Video prompting guide
+npx skills add inference-sh/skills@video-prompting-guide
+
+# LLM models
+npx skills add inference-sh/skills@llm-models
+
+# Image generation
+npx skills add inference-sh/skills@ai-image-generation
+
+# Full platform skill
+npx skills add inference-sh/skills@inference-sh
+```
+
+Browse all apps: `infsh app list`

package/assets/.agent/skills/remotion/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: remotion
+description: Best practices for Remotion - Video creation in React
+metadata:
+  tags: remotion, video, react, animation, composition
+---
+
+## When to use
+
+Use this skills whenever you are dealing with Remotion code to obtain the domain-specific knowledge.
+
+## How to use
+
+Read individual rule files for detailed explanations and code examples:
+
+- [rules/3d.md](rules/3d.md) - 3D content in Remotion using Three.js and React Three Fiber
+- [rules/animations.md](rules/animations.md) - Fundamental animation skills for Remotion
+- [rules/assets.md](rules/assets.md) - Importing images, videos, audio, and fonts into Remotion
+- [rules/audio.md](rules/audio.md) - Using audio and sound in Remotion - importing, trimming, volume, speed, pitch
+- [rules/calculate-metadata.md](rules/calculate-metadata.md) - Dynamically set composition duration, dimensions, and props
+- [rules/can-decode.md](rules/can-decode.md) - Check if a video can be decoded by the browser using Mediabunny
+- [rules/charts.md](rules/charts.md) - Chart and data visualization patterns for Remotion
+- [rules/compositions.md](rules/compositions.md) - Defining compositions, stills, folders, default props and dynamic metadata
+- [rules/display-captions.md](rules/display-captions.md) - Displaying captions in Remotion with TikTok-style pages and word highlighting
+- [rules/extract-frames.md](rules/extract-frames.md) - Extract frames from videos at specific timestamps using Mediabunny
+- [rules/fonts.md](rules/fonts.md) - Loading Google Fonts and local fonts in Remotion
+- [rules/get-audio-duration.md](rules/get-audio-duration.md) - Getting the duration of an audio file in seconds with Mediabunny
+- [rules/get-video-dimensions.md](rules/get-video-dimensions.md) - Getting the width and height of a video file with Mediabunny
+- [rules/get-video-duration.md](rules/get-video-duration.md) - Getting the duration of a video file in seconds with Mediabunny
+- [rules/gifs.md](rules/gifs.md) - Displaying GIFs synchronized with Remotion's timeline
+- [rules/images.md](rules/images.md) - Embedding images in Remotion using the Img component
+- [rules/import-srt-captions.md](rules/import-srt-captions.md) - Importing .srt subtitle files into Remotion using @remotion/captions
+- [rules/lottie.md](rules/lottie.md) - Embedding Lottie animations in Remotion
+- [rules/measuring-dom-nodes.md](rules/measuring-dom-nodes.md) - Measuring DOM element dimensions in Remotion
+- [rules/measuring-text.md](rules/measuring-text.md) - Measuring text dimensions, fitting text to containers, and checking overflow
+- [rules/sequencing.md](rules/sequencing.md) - Sequencing patterns for Remotion - delay, trim, limit duration of items
+- [rules/tailwind.md](rules/tailwind.md) - Using TailwindCSS in Remotion
+- [rules/text-animations.md](rules/text-animations.md) - Typography and text animation patterns for Remotion
+- [rules/timing.md](rules/timing.md) - Interpolation curves in Remotion - linear, easing, spring animations
+- [rules/transcribe-captions.md](rules/transcribe-captions.md) - Transcribing audio to generate captions in Remotion
+- [rules/transitions.md](rules/transitions.md) - Scene transition patterns for Remotion
+- [rules/trimming.md](rules/trimming.md) - Trimming patterns for Remotion - cut the beginning or end of animations
+- [rules/videos.md](rules/videos.md) - Embedding videos in Remotion - trimming, volume, speed, looping, pitch
+- [rules/parameters.md](rules/parameters.md) - Make a video parametrizable by adding a Zod schema
+- [rules/maps.md](rules/maps.md) - Add a map using Mapbox and animate it