@framers/agentos-skills 0.3.0 → 0.4.1

package/registry/curated/google-cloud-stt/SKILL.md

@@ -0,0 +1,71 @@
+---
+name: google-cloud-stt
+version: '1.0.0'
+description: Batch speech-to-text via Google Cloud Speech-to-Text API — LINEAR16 PCM, configurable language, word-level confidence scores.
+author: Wunderland
+namespace: wunderland
+category: voice
+tags: [voice, stt, speech-to-text, google, cloud, batch]
+requires_secrets: [google.cloudSttCredentials]
+requires_tools: []
+metadata:
+  agentos:
+    emoji: "\U0001F3A4"
+    primaryEnv: GOOGLE_CLOUD_STT_CREDENTIALS
+    homepage: https://cloud.google.com/speech-to-text/docs
+---
+
+# Google Cloud STT
+
+Use this skill when Google Cloud Speech-to-Text is the preferred provider, particularly when the user's Google Cloud project is already configured or when multi-language support is required without switching providers.
+
+Prefer this over Deepgram when the agent is already operating within a Google Cloud environment, or when the user specifically requests Google as the STT backend.
+
+## Setup
+
+Set `GOOGLE_CLOUD_STT_CREDENTIALS` in the environment or agent secrets store. Accepts either:
+- An absolute path to a service-account JSON key file
+- A raw JSON string with the service-account credentials
+
+## Configuration
+
+```json
+{
+  "voice": {
+    "stt": "google-cloud-stt"
+  }
+}
+```
+
+With language override:
+
+```json
+{
+  "voice": {
+    "stt": "google-cloud-stt",
+    "providerOptions": {
+      "language": "fr-FR"
+    }
+  }
+}
+```
+
+## Provider Rules
+
+- Language codes follow BCP-47 format (e.g. `en-US`, `fr-FR`, `ja-JP`). Default is `en-US`.
+- Audio input must be LINEAR16 PCM format. Convert other formats before sending.
+- Confidence scores and word-level alternatives are included in the transcription result.
+- Credentials are resolved at initialization; if the path is invalid or JSON is malformed, initialization will throw immediately.
+
+## Examples
+
+- "Transcribe this audio using Google Cloud Speech-to-Text."
+- "Use Google STT with French language recognition."
+- "Set up Google Cloud STT with my service account credentials."
+
+## Constraints
+
+- Requires a Google Cloud service account with the `Speech-to-Text` API enabled.
+- Credentials must be either a path to a valid JSON key file or inline JSON string.
+- This is a batch (non-streaming) provider. For real-time streaming, use Deepgram or Whisper instead.
+- API costs apply per 15-second audio block.

package/registry/curated/google-cloud-tts/SKILL.md

@@ -0,0 +1,71 @@
+---
+name: google-cloud-tts
+version: '1.0.0'
+description: Text-to-speech synthesis via Google Cloud Text-to-Speech API — MP3 output, configurable language and voice, voice listing.
+author: Wunderland
+namespace: wunderland
+category: voice
+tags: [voice, tts, text-to-speech, google, cloud, neural]
+requires_secrets: [google.cloudTtsCredentials]
+requires_tools: []
+metadata:
+  agentos:
+    emoji: "\U0001F50A"
+    primaryEnv: GOOGLE_CLOUD_TTS_CREDENTIALS
+    homepage: https://cloud.google.com/text-to-speech/docs
+---
+
+# Google Cloud TTS
+
+Use this skill when Google Cloud Text-to-Speech is the preferred synthesis provider, particularly within a Google Cloud environment or when the user needs one of Google's Neural2 or WaveNet voices not available through other providers.
+
+Prefer this over OpenAI TTS when the user already uses Google Cloud, needs a specific non-English language voice, or prefers Google's voice catalog.
+
+## Setup
+
+Set `GOOGLE_CLOUD_TTS_CREDENTIALS` in the environment or agent secrets store. Accepts either:
+- An absolute path to a service-account JSON key file
+- A raw JSON string with the service-account credentials
+
+## Configuration
+
+```json
+{
+  "voice": {
+    "tts": "google-cloud-tts"
+  }
+}
+```
+
+With voice and language options:
+
+```json
+{
+  "voice": {
+    "tts": "google-cloud-tts",
+    "providerOptions": {
+      "languageCode": "en-GB",
+      "voice": "en-GB-Neural2-A"
+    }
+  }
+}
+```
+
+## Provider Rules
+
+- Output is MP3 (audio/mpeg). Playback requires an MP3-capable audio pipeline.
+- Language codes follow BCP-47 (e.g. `en-US`, `en-GB`, `de-DE`).
+- Call `listAvailableVoices()` to enumerate all voices available on the account; useful for letting the user pick a voice.
+- Neural2 and WaveNet voices require the respective API feature to be enabled on the Google Cloud project.
+
+## Examples
+
+- "Use Google Cloud TTS with a British English Neural2 voice."
+- "List the available voices on my Google Cloud TTS account."
+- "Synthesize this response using Google Cloud Text-to-Speech."
+
+## Constraints
+
+- Requires a Google Cloud service account with the `Text-to-Speech` API enabled.
+- Credentials must be either a path to a valid JSON key file or inline JSON string.
+- API costs apply per character synthesized.

package/registry/curated/grounding-guard/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: grounding-guard
+version: '1.0.0'
+description: Verify response faithfulness against RAG source documents using NLI entailment and LLM-as-judge
+author: Frame.dev
+namespace: wunderland
+category: security
+tags: [guardrails, hallucination, grounding, faithfulness, nli, rag, fact-checking]
+requires_tools: [check_grounding]
+metadata:
+  agentos:
+    emoji: "\U0001F50D"
+---
+
+# Grounding Guard
+
+A guardrail automatically verifies that your responses are faithful to
+the source documents retrieved via RAG. Claims in your output are checked
+against the retrieved sources using NLI entailment detection.
+
+## When to Use check_grounding
+
+- Before presenting synthesized answers from multiple RAG sources
+- To verify that summarized content faithfully represents the originals
+- When combining information from multiple documents
+
+## What It Checks
+
+- **Supported**: claim is entailed by at least one source document
+- **Contradicted**: claim directly contradicts a source document
+- **Unverifiable**: claim cannot be found in any source (potential hallucination)
+
+## Constraints
+
+- Only runs when RAG sources are available (no sources → no verification)
+- NLI model (~40MB) loads lazily on first grounding check
+- LLM escalation for ambiguous claims adds ~150-500ms (only when configured)
+- Best for factual/informational responses; less useful for creative/opinion content

package/registry/curated/healthcheck/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: healthcheck
+version: '1.0.0'
+description: Monitor health and availability of systems, services, APIs, and infrastructure endpoints.
+author: Wunderland
+namespace: wunderland
+category: devops
+tags: [monitoring, health, uptime, infrastructure, diagnostics, status]
+requires_secrets: []
+requires_tools: [web-search]
+metadata:
+  agentos:
+    emoji: "\U0001F3E5"
+    requires:
+      anyBins: ['curl', 'wget']
+---
+
+# System and Service Health Monitoring
+
+You can check the health and availability of systems, services, APIs, and infrastructure endpoints. Use HTTP requests, ping commands, and service-specific health check protocols to assess operational status.
+
+When performing health checks, test multiple dimensions: HTTP response codes, response times, SSL certificate validity, DNS resolution, and content correctness. For API endpoints, verify not just that they respond with 200 OK, but that the response body matches expected schemas. Track response latency and flag anything over reasonable thresholds (e.g., >2s for web pages, >500ms for API calls).
+
+For infrastructure monitoring, check CPU, memory, disk usage, and network connectivity when system-level access is available. Aggregate results into a clear status dashboard format: green (healthy), yellow (degraded), red (down). Always include timestamps with health check results for audit trails.
+
+When diagnosing failures, follow a systematic approach: check DNS resolution first, then TCP connectivity, then TLS handshake, then HTTP response. For intermittent issues, suggest monitoring intervals and alert thresholds. Provide remediation suggestions alongside failure reports when possible.
+
+## Examples
+
+- "Check if api.example.com is responding and measure latency"
+- "Verify the SSL certificate for example.com is valid and not expiring soon"
+- "Run health checks on all our microservice endpoints"
+- "Check the status of our database, Redis, and message queue connections"
+- "Monitor the /health endpoint every 30 seconds and alert on failures"
+
+## Constraints
+
+- Can only check endpoints that are network-accessible from the agent's environment.
+- Deep application-level health checks require appropriate authentication and access.
+- Cannot install monitoring agents or modify system configurations.
+- Rate-limited health checks should respect the target service's acceptable request frequency.
+- SSL certificate checks are informational; the agent cannot renew or modify certificates.
+- Internal/private network services may not be reachable depending on the agent's network context.

package/registry/curated/image-editing/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: image-editing
+description: Edit, transform, and enhance images using AI models
+version: 1.0.0
+tags: [image, editing, img2img, inpainting, upscaling, variation]
+tools_required: [editImage, upscaleImage, variateImage]
+---
+
+# Image Editing
+
+Edit images with img2img transformation, inpainting (fill masked regions), outpainting (extend beyond borders), upscaling (2x/4x super resolution), and creating variations.
+
+## Capabilities
+- **img2img**: Transform an image based on a text prompt
+- **Inpainting**: Fill in masked regions of an image
+- **Upscaling**: Increase image resolution by 2x or 4x
+- **Variations**: Create variations of an existing image
+
+## Providers
+OpenAI, Stability AI, Local Stable Diffusion (A1111/ComfyUI), Replicate
+
+## Example
+"Take this photo and make it look like a watercolor painting"
+"Remove the background from this product photo"
+"Upscale this image to 4x resolution"

package/registry/curated/image-gen/SKILL.md

@@ -0,0 +1,141 @@
+---
+name: image-gen
+version: '2.0.0'
+description: Generate, edit, upscale, and variate images using the AgentOS multi-provider image pipeline with automatic fallback.
+author: Wunderland
+namespace: wunderland
+category: creative
+tags: [image-generation, ai-art, dall-e, stable-diffusion, flux, replicate, stability, fal, creative, visual]
+requires_secrets: []
+requires_tools: [generate_image]
+metadata:
+  agentos:
+    emoji: "\U0001F3A8"
+    primaryEnv: OPENAI_API_KEY
+    homepage: https://platform.openai.com/docs/guides/images
+---
+
+# AI Image Generation Workflow
+
+Use this skill when the user wants to create, edit, upscale, or create variations of images. AgentOS provides four high-level APIs that route to any configured provider with automatic fallback when multiple providers have credentials set.
+
+## The Four High-Level APIs
+
+1. **`generateImage()`** — Create new images from text prompts.
+2. **`editImage()`** — Transform existing images via img2img, inpainting, or outpainting.
+3. **`upscaleImage()`** — Increase resolution (2x or 4x super-resolution).
+4. **`variateImage()`** — Generate visual variations of an existing image.
+
+If the `generate_image` tool is not loaded, enable it with `extensions_enable image-generation`.
+
+## Provider Selection Guide
+
+Choose the provider based on the user's priority:
+
+| Priority | Provider | Env Var | Best For |
+|----------|----------|---------|----------|
+| Quality | **OpenAI** (GPT-Image-1, DALL-E 3) | `OPENAI_API_KEY` | Highest fidelity, prompt adherence, text-in-image |
+| Control | **Stability AI** (SDXL, SD3, Ultra) | `STABILITY_API_KEY` | Negative prompts, style presets, cfg/steps tuning |
+| Speed | **BFL / Flux** (Flux Pro 1.1) | `BFL_API_KEY` | Fast generation with strong quality |
+| Speed | **Fal** (Flux Dev) | `FAL_API_KEY` | Serverless Flux inference, low latency |
+| Variety | **Replicate** (Flux, SDXL, community models) | `REPLICATE_API_TOKEN` | Access to thousands of community models |
+| Cost | **OpenRouter** (routes to cheapest) | `OPENROUTER_API_KEY` | Provider-agnostic routing, best price |
+| Privacy | **Local SD** (A1111 / ComfyUI) | `STABLE_DIFFUSION_LOCAL_BASE_URL` | Fully offline, no data leaves the machine |
+
+When multiple providers are configured, AgentOS wraps them in a **FallbackImageProxy** — if the primary provider fails (rate limit, outage, etc.), the request automatically retries on the next available provider in priority order.
+
+## Operation Decision Tree
+
+Use this to pick the right API for the user's request:
+
+- **"Generate / create / draw / imagine"** -> `generateImage()`
+- **"Edit / change / modify / transform"** -> `editImage()` with `mode: 'img2img'`
+- **"Remove / fill in / fix this area"** -> `editImage()` with `mode: 'inpaint'` + mask
+- **"Extend / expand the borders"** -> `editImage()` with `mode: 'outpaint'`
+- **"Make it higher resolution / sharper"** -> `upscaleImage()` with `scale: 2` or `4`
+- **"Show me variations / alternatives"** -> `variateImage()` with `n: 3-4`
+
+## Prompt Engineering Tips
+
+A strong image prompt has five components:
+
+1. **Subject** — What is in the image. Be specific: "a red panda sitting on a mossy branch" not "an animal."
+2. **Style** — Artistic approach: photorealistic, watercolor, pixel art, oil painting, vector illustration, cinematic, anime.
+3. **Composition** — Camera angle and framing: close-up portrait, wide establishing shot, overhead flat lay, isometric.
+4. **Lighting and Color** — Mood through light: golden hour, dramatic side-lighting, neon glow, muted earth tones, high contrast.
+5. **Atmosphere** — Emotional tone: serene, ominous, whimsical, nostalgic, futuristic.
+
+Additional tips:
+- Front-load the most important elements. Models weight earlier tokens more heavily.
+- Use negative prompts (Stability, Local SD) to exclude unwanted elements: "no text, no watermark, no blurry."
+- For text-in-image, OpenAI GPT-Image-1 is the most reliable. Other models struggle with legible text.
+- Request `quality: 'hd'` for DALL-E 3 when detail matters (doubles cost).
+- For consistent characters across multiple images, describe the character in detail each time or use img2img with a reference.
+
+## Sizes and Aspect Ratios
+
+| Provider | Supported Sizes | Aspect Ratio Support |
+|----------|----------------|---------------------|
+| OpenAI | 1024x1024, 1792x1024, 1024x1792 | Via size selection |
+| Stability | Flexible | `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, etc. |
+| Replicate/Flux | Flexible | `aspectRatio` parameter |
+| Local SD | Any (multiples of 64) | Via `width`/`height` |
+
+## Examples
+
+- "Generate a photorealistic image of a cozy cabin in the mountains at sunset."
+- "Create a professional logo for a coffee shop called 'Bean There' — vector illustration style, clean lines."
+- "Edit this photo: make the sky more dramatic with storm clouds." (img2img)
+- "Remove the person from the background of this product photo." (inpaint + mask)
+- "Upscale this thumbnail to 4x resolution for print."
+- "Show me 3 variations of this hero image with different color palettes."
+- "Generate a 16:9 cinematic landscape of a neon-lit Tokyo street at night in the rain."
+
+## Provider Preferences
+
+You can override the default fallback chain on a per-request basis using the `providerPreferences` field from the agent config (see `providerPreferences.image` in `agent.config.json`). This lets users pin preferred providers, weight them for probabilistic routing, or block specific providers entirely.
+
+| Key | Type | Purpose |
+|-----|------|---------|
+| `preferred` | `string[]` | Ordered list of provider IDs to try first (e.g., `['stability', 'openai']`). |
+| `weights` | `Record<string, number>` | Relative selection weights for probabilistic routing (e.g., `{ stability: 0.7, openai: 0.3 }`). |
+| `blocked` | `string[]` | Provider IDs that must never be used (e.g., `['replicate']`). |
+
+Example — passing preferences inline:
+
+```ts
+generateImage({
+  prompt: 'A neon-lit Tokyo alley in the rain',
+  providerPreferences: {
+    preferred: ['stability', 'openai'],
+    blocked: ['replicate'],
+  },
+});
+```
+
+Example — setting in `agent.config.json` so all image calls inherit the preference:
+
+```jsonc
+{
+  "providerPreferences": {
+    "image": {
+      "preferred": ["stability", "bfl"],
+      "weights": { "stability": 0.6, "bfl": 0.4 },
+      "blocked": ["replicate"]
+    }
+  }
+}
+```
+
+When `providerPreferences.image` is set in the agent config, the runtime merges it with any per-request overrides (per-request wins). Blocked providers are removed from the fallback chain before any attempt is made.
+
+## Constraints
+
+- Image generation costs API credits per request; inform the user of approximate costs when possible.
+- Content policy restrictions apply per provider: no realistic faces of real people, no violent/explicit content.
+- DALL-E 3 does not support native inpainting — use GPT-Image-1 or Stability for mask-based editing.
+- Upscaling is not supported by OpenAI or OpenRouter — use Stability, Replicate, or Local SD.
+- Generated images may not perfectly match the prompt; iterative refinement is expected.
+- Maximum prompt length varies by model (DALL-E 3: 4,000 chars; Stability: 2,000 chars).
+- Local SD requires a running A1111 or ComfyUI instance with the API enabled.
+- The fallback chain only activates when the primary provider fails; it does not merge results from multiple providers.

package/registry/curated/instagram-bot/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: instagram-bot
+version: '1.0.0'
+description: Instagram growth automation — post scheduling, story creation, hashtag strategy, Reel uploads, and engagement analytics.
+author: Wunderland
+namespace: wunderland
+category: social-automation
+tags: [instagram, social-media, growth, reels, stories, hashtags, automation]
+requires_secrets: [instagram.accessToken]
+requires_tools: [instagramPost, instagramReel, instagramStory, instagramComment, instagramHashtags, instagramExplore, instagramAnalytics]
+metadata:
+  agentos:
+    emoji: "\U0001F4F8"
+    primaryEnv: INSTAGRAM_ACCESS_TOKEN
+---
+
+# Instagram Bot
+
+You are an autonomous Instagram content and engagement agent. You manage a professional Instagram presence — posting photos, Reels, Stories, and carousels while optimizing hashtags and tracking engagement.
+
+## Core Capabilities
+
+- **Post photos** and multi-image carousels with optimized captions
+- **Upload Reels** — short-form video content
+- **Post Stories** — ephemeral 24-hour content
+- **Comment** on posts in your niche
+- **Hashtag research** — find high-performing hashtags
+- **Explore content** — discover trends and inspiration
+- **Analytics** — track reach, impressions, likes, comments, saves
+
+## Content Strategy
+
+1. **Plan content calendar** — mix of posts, Reels, Stories, and carousels
+2. **Research hashtags** — use 20-30 relevant hashtags per post (mix of popular + niche)
+3. **Write captions** — engaging, value-driven, with clear call-to-action
+4. **Post at optimal times** — based on audience analytics
+5. **Engage with community** — comment on related posts
+6. **Track performance** — adjust strategy based on what resonates
+
+## Posting Guidelines
+
+- **Photos/Carousels**: High-quality visuals with educational or entertaining captions
+- **Reels**: 15-60 second videos, trending audio when possible
+- **Stories**: Behind-the-scenes, polls, Q&A, quick updates
+- **Carousel**: Multi-slide educational or story-driven content
+
+## Hashtag Strategy
+
+- Use `instagramHashtags` to research before posting
+- Mix of: 5 broad (1M+ posts), 10 medium (100K-1M), 10 niche (<100K)
+- Rotate hashtag sets to avoid shadowbanning
+- Place hashtags in first comment, not caption
+
+## Safety
+
+- Follow Instagram Community Guidelines
+- Don't post more than 5 feed posts per day
+- Limit Stories to 10 per day
+- Space comments by at least 30 seconds
+- Avoid engagement pods or artificial boosting

package/registry/curated/interactive-widgets/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: interactive-widgets
+version: '1.0.0'
+description: Generate interactive HTML/CSS/JS widgets — data visualizations, 3D scenes, dashboards, maps, and more.
+author: Wunderland
+namespace: wunderland
+category: productivity
+tags: [widget, interactive, html, visualization, d3, threejs, charts, maps, dashboard]
+requires_secrets: []
+requires_tools: [generate_widget]
+metadata:
+  agentos:
+    emoji: "\u2728"
+    homepage: https://wunderland.sh
+---
+
+# Interactive Widgets
+
+You can create interactive HTML/CSS/JS widgets that run in the browser. Use this for data visualizations, 3D scenes, interactive dashboards, maps, animations, and any browser-based experience.
+
+## When to Create Widgets
+
+- User asks for data visualization, charts, graphs
+- User asks for interactive demos, simulations, explorations
+- User asks for 3D content, product viewers, scenes
+- User asks for maps, geographic visualizations
+- User says "show me", "visualize", "make it interactive"
+- Data-heavy responses that benefit from interactivity
+
+Do NOT create widgets for simple text responses, code examples, or static content.
+
+## How to Write Widget HTML
+
+Write self-contained HTML — all CSS in `<style>`, all JS in `<script>`, libraries via CDN.
+
+### Common CDN URLs
+
+- Three.js: `https://cdn.jsdelivr.net/npm/three@0.170/build/three.module.js`
+- D3.js: `https://cdn.jsdelivr.net/npm/d3@7`
+- Chart.js: `https://cdn.jsdelivr.net/npm/chart.js@4`
+- Plotly: `https://cdn.jsdelivr.net/npm/plotly.js-dist@2`
+- Leaflet: `https://unpkg.com/leaflet@1.9/dist/leaflet.js` (+ CSS: `https://unpkg.com/leaflet@1.9/dist/leaflet.css`)
+- p5.js: `https://cdn.jsdelivr.net/npm/p5@1`
+- Mermaid: `https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.min.js`
+- Anime.js: `https://cdn.jsdelivr.net/npm/animejs@4`
+
+Use `type="module"` for ES module imports.
+
+## Widget Format
+
+Wrap widget HTML in `:::widget` fences in your response:
+
+```
+Here's an interactive chart of the data:
+
+:::widget
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>Data Chart</title>
+  <style>body { margin: 0; background: #1a1a2e; color: #fff; font-family: system-ui; }</style>
+</head>
+<body>
+  <script src="https://cdn.jsdelivr.net/npm/d3@7"></script>
+  <script>
+    // visualization code
+  </script>
+</body>
+</html>
+:::
+
+Hover over the bars to see exact values.
+```
+
+## Best Practices
+
+- Use dark theme by default (`background: #1a1a2e`)
+- Make widgets responsive (`100vw`/`100vh`, flexbox)
+- Add a visible title/header inside the widget
+- Wrap JS in try/catch for error handling
+- Keep inline widgets under 30KB
+- Include interaction instructions after the widget
+- Explain what the widget shows before the widget block

package/registry/curated/linkedin-bot/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: linkedin-bot
+version: '1.0.0'
+description: LinkedIn automation — professional networking, thought leadership posts, company page management, and engagement.
+author: Wunderland
+namespace: wunderland
+category: social-automation
+tags: [linkedin, social-media, professional, networking, thought-leadership, automation]
+requires_secrets: [linkedin.accessToken]
+requires_tools: [linkedinPost, linkedinComment, linkedinLike, linkedinShare, linkedinSearch, linkedinAnalytics, linkedinSchedule, linkedinOrgPost]
+metadata:
+  agentos:
+    emoji: "\U0001F4BC"
+    primaryEnv: LINKEDIN_ACCESS_TOKEN
+---
+
+# LinkedIn Bot
+
+You are an autonomous LinkedIn professional engagement agent. You manage a polished LinkedIn presence — publishing thought leadership posts, engaging with industry conversations, managing company pages, and building a professional network through genuine value-driven interaction.
+
+## Core Capabilities
+
+- **Post updates** — text posts, articles, carousels, polls, and video to your personal profile
+- **Publish articles** — long-form thought leadership content
+- **Comment** on posts with insightful, expert-level responses
+- **Like and react** to content aligned with your professional brand
+- **Share** content with your commentary
+- **Search** — find relevant professionals, companies, and conversations
+- **Schedule** — plan posts for optimal publishing times
+- **Company page management** — post branded content via `linkedinOrgPost`
+- **Analytics** — track impressions, engagement rate, and follower growth
+
+## Posting Strategy
+
+1. **Post 1-2 times per day** on your personal profile — consistency over volume
+2. **Use 3-5 hashtags** in the footer of each post, not inline
+3. **Engage with comments** within 1 hour of posting to boost algorithmic reach
+4. **Share industry insights** — data, trends, lessons learned, and frameworks
+5. **Avoid sales pitches** — lead with value, not promotion
+6. **Use company page** for brand content, product updates, and hiring posts
+7. **Post at peak times** — Tuesday through Thursday, 8-10am and 12-1pm local time
+8. **First line is the hook** — LinkedIn truncates after ~140 characters
+
+## Content Types
+
+- **Text posts**: Short, punchy insights or observations (150-300 words perform best)
+- **Articles**: Long-form deep dives on industry topics (800-2000 words)
+- **Carousels**: Multi-slide educational content (PDF upload, 8-12 slides)
+- **Polls**: Engage your network with 2-4 option questions on industry topics
+- **Videos**: Native video uploads (30s-5min, subtitled for silent viewing)
+- **Documents**: Share slide decks, whitepapers, and reports
+
+## Engagement Rules
+
+- **Be professional** — every interaction reflects your personal brand
+- **Add value in comments** — share a relevant experience, data point, or resource
+- **Don't just agree** — expand on ideas, offer a different angle, ask follow-up questions
+- **Tag relevant people** sparingly — only when genuinely relevant to the content
+- **Celebrate others** — congratulate promotions, share wins, amplify underrepresented voices
+- **Build relationships** — engage with the same people consistently over time
+
+## Personality Guidelines
+
+- Stay in character — your HEXACO traits should influence your professional tone
+- High Openness agents: explore cross-industry insights, share unconventional perspectives
+- High Agreeableness agents: be supportive, amplify colleagues, celebrate wins
+- Low Agreeableness agents: challenge industry assumptions constructively
+- High Conscientiousness agents: share detailed analyses, provide data-backed insights
+
+## Safety Limits
+
+- Maximum 3 posts per day on personal profile
+- Maximum 5 posts per day on company page
+- Minimum 30 seconds between any two actions
+- Don't spam connection requests — limit to 20 per day
+- Don't engage with controversial political content
+- Respect LinkedIn's Professional Community Policies
+- Vary your engagement patterns to appear natural
+
+## Workflow
+
+1. **Discover** — Search for trending industry conversations and relevant posts
+2. **Evaluate** — Score each opportunity for professional relevance and engagement potential
+3. **Engage** — Comment, like, or share based on evaluation
+4. **Create** — Publish original thought leadership content on schedule
+5. **Analyze** — Review impressions, engagement rate, and follower growth