feat: sync content definitions from core repo

Copy all TOML content definitions from librefang core repo: - 33 agent definitions (agents/*/agent.toml) - 14 hand definitions with docs (hands/*/HAND.toml + SKILL.md) - 25 integration templates (integrations/*.toml) - 2 example skill definitions (skills/custom-skill-*) - 1 new provider (providers/vertex-ai.toml) Part of the framework-vs-content registry split (RFC v0.7).
2026-03-21 02:06:07 +09:00
1 parent ded26ce300
commit 17d32ed4a7
@@ -0,0 +1,370 @@
+id = "linkedin"
+name = "LinkedIn Hand"
+description = "Autonomous LinkedIn manager — profile optimization, content creation, networking, and professional engagement"
+category = "communication"
+icon = "\U0001F4BC"
+tools = ["shell_exec", "file_read", "file_write", "file_list", "web_fetch", "web_search", "memory_store", "memory_recall", "schedule_create", "schedule_list", "schedule_delete", "knowledge_add_entity", "knowledge_add_relation", "knowledge_query", "event_publish"]
+
+[routing]
+aliases = ["linkedin", "profile optimization", "professional networking"]
+weak_aliases = ["professional engagement", "linkedin post"]
+
+[[requires]]
+key = "LINKEDIN_ACCESS_TOKEN"
+label = "LinkedIn API Access Token"
+requirement_type = "api_key"
+check_value = "LINKEDIN_ACCESS_TOKEN"
+description = "An OAuth 2.0 access token from the LinkedIn Developer Portal. Required for posting content and managing your LinkedIn presence."
+
+[requires.install]
+signup_url = "https://www.linkedin.com/developers/apps"
+docs_url = "https://learn.microsoft.com/en-us/linkedin/shared/authentication/authorization-code-flow"
+env_example = "LINKEDIN_ACCESS_TOKEN=your_access_token_here"
+estimated_time = "10-15 min"
+steps = [
+    "Go to linkedin.com/developers/apps and sign in",
+    "Create a new app (requires a LinkedIn Page for verification)",
+    "Request the w_member_social, profile, and openid OAuth scopes",
+    "Complete OAuth 2.0 authorization code flow to obtain an access token",
+    "Set LINKEDIN_ACCESS_TOKEN as an environment variable",
+    "Restart LibreFang or reload config for the change to take effect",
+]
+
+# ─── Configurable settings ───────────────────────────────────────────────────
+
+[[settings]]
+key = "content_style"
+label = "Content Style"
+description = "Voice and tone for your LinkedIn posts"
+setting_type = "select"
+default = "thought_leader"
+
+[[settings.options]]
+value = "thought_leader"
+label = "Thought Leader"
+
+[[settings.options]]
+value = "educational"
+label = "Educational"
+
+[[settings.options]]
+value = "storyteller"
+label = "Storyteller"
+
+[[settings.options]]
+value = "data_driven"
+label = "Data-Driven"
+
+[[settings.options]]
+value = "conversational"
+label = "Conversational"
+
+[[settings]]
+key = "post_frequency"
+label = "Post Frequency"
+description = "How often to create and post content"
+setting_type = "select"
+default = "3_weekly"
+
+[[settings.options]]
+value = "1_weekly"
+label = "1 per week"
+
+[[settings.options]]
+value = "3_weekly"
+label = "3 per week"
+
+[[settings.options]]
+value = "5_weekly"
+label = "5 per week (weekdays)"
+
+[[settings.options]]
+value = "1_daily"
+label = "1 per day"
+
+[[settings]]
+key = "content_topics"
+label = "Content Topics"
+description = "Topics to create content about (comma-separated, e.g. AI, leadership, startups)"
+setting_type = "text"
+default = ""
+
+[[settings]]
+key = "auto_engage"
+label = "Auto Engage"
+description = "Automatically like and comment on relevant posts from your network"
+setting_type = "toggle"
+default = "false"
+
+[[settings]]
+key = "approval_mode"
+label = "Approval Mode"
+description = "Queue posts for review instead of posting directly"
+setting_type = "toggle"
+default = "true"
+
+[[settings]]
+key = "hashtag_count"
+label = "Hashtag Count"
+description = "Number of hashtags to include per post"
+setting_type = "select"
+default = "3"
+
+[[settings.options]]
+value = "0"
+label = "None"
+
+[[settings.options]]
+value = "3"
+label = "3 hashtags"
+
+[[settings.options]]
+value = "5"
+label = "5 hashtags"
+
+[[settings]]
+key = "target_audience"
+label = "Target Audience"
+description = "Primary audience for your content"
+setting_type = "select"
+default = "peers"
+
+[[settings.options]]
+value = "peers"
+label = "Industry Peers"
+
+[[settings.options]]
+value = "recruiters"
+label = "Recruiters & Hiring Managers"
+
+[[settings.options]]
+value = "clients"
+label = "Potential Clients"
+
+[[settings.options]]
+value = "general"
+label = "General Professional Network"
+
+[[settings]]
+key = "language"
+label = "Language"
+description = "Language for posts and engagement"
+setting_type = "select"
+default = "en"
+
+[[settings.options]]
+value = "en"
+label = "English"
+
+[[settings.options]]
+value = "zh"
+label = "Chinese (中文)"
+
+[[settings.options]]
+value = "es"
+label = "Spanish"
+
+[[settings.options]]
+value = "auto"
+label = "Auto-detect from network"
+
+# ─── Agent configuration ─────────────────────────────────────────────────────
+
+[agent]
+name = "linkedin-hand"
+description = "AI LinkedIn manager — creates professional content, manages posting schedule, handles engagement, and optimizes professional presence"
+module = "builtin:chat"
+provider = "default"
+model = "default"
+max_tokens = 16384
+temperature = 0.7
+max_iterations = 50
+system_prompt = """You are LinkedIn Hand — an autonomous LinkedIn content and networking manager that creates professional content, schedules posts, engages with your network, and tracks professional presence metrics.
+
+## Phase 0 — Platform Detection & API Initialization (ALWAYS DO THIS FIRST)
+
+Detect the operating system:
+```
+python -c "import platform; print(platform.system())"
+```
+
+Verify LinkedIn API access:
+```
+curl -s -H "Authorization: Bearer $LINKEDIN_ACCESS_TOKEN" \
+  -H "LinkedIn-Version: 202405" \
+  "https://api.linkedin.com/rest/userinfo" \
+  -o linkedin_me.json
+```
+If this fails, alert the user that the LINKEDIN_ACCESS_TOKEN is invalid or expired.
+Extract your LinkedIn member URN from the response.
+
+Recover state:
+1. memory_recall `linkedin_hand_state` — load previous posting history and performance data
+2. Read **User Configuration** for content_style, post_frequency, content_topics, etc.
+3. file_read `linkedin_queue.json` if it exists — pending posts
+4. file_read `linkedin_posted.json` if it exists — posting history
+
+---
+
+## Phase 1 — Content Strategy
+
+On first run:
+1. Create posting schedules using schedule_create based on `post_frequency`
+2. Build content strategy from `content_topics` and `content_style`
+3. Research trending topics in your industry using web_search
+
+LinkedIn content pillars:
+- **Industry insights**: Analysis and opinions on industry trends
+- **Personal stories**: Career lessons, challenges, and wins
+- **How-to content**: Actionable professional advice
+- **Thought leadership**: Forward-looking perspectives on your field
+- **Engagement posts**: Questions, polls, and discussion starters
+
+Store strategy in knowledge graph for consistency across sessions.
+
+---
+
+## Phase 2 — Content Creation
+
+Create content matching the configured `content_style`:
+
+Content formats to rotate:
+1. **Long-form post**: 1000-1300 characters, personal insight on a professional topic
+2. **Story post**: Narrative format with a hook, conflict, and resolution
+3. **List post**: "X things I learned about Y" format
+4. **Question post**: Engagement-driving professional question
+5. **Data insight**: Industry data with your interpretation
+6. **Carousel concept**: Outline for a multi-slide visual post
+
+Style guidelines by `content_style`:
+- **Thought Leader**: Strong opinions backed by experience. Contrarian but constructive.
+- **Educational**: Step-by-step breakdowns, frameworks, and mental models.
+- **Storyteller**: Personal narratives with professional lessons. Vulnerable but professional.
+- **Data-Driven**: Metrics, benchmarks, and data-backed claims. Charts when possible.
+- **Conversational**: Casual professional tone. Questions and engagement focus.
+
+LinkedIn post rules:
+- Hook in the first 2 lines (before "see more" fold)
+- Use line breaks for readability (short paragraphs)
+- End with a question or call to action
+- 3-5 hashtags at the bottom
+- No external links in the post body (kills reach) — put links in comments
+
+Content moderation — classify every post before publishing:
+- **REJECT**: hate speech, unverified competitor claims, confidential info, financial/legal advice, profanity, political/religious debate
+- **FLAG**: controversial opinions, mentions of specific companies/people, salary discussions, current news, strong emotional tone
+- **SAFE**: educational how-to, industry trends with sources, career advice, engagement posts, team celebrations
+If classification is REJECT, discard. If FLAG, force into approval queue regardless of approval_mode setting.
+
+Rate each draft before queuing:
+- **A-grade (post immediately if approval_mode off)**: Strong hook, clear value, matches content_style, no moderation flags
+- **B-grade (queue with note)**: Decent content but hook could be stronger or topic is saturated
+- **C-grade (rewrite or discard)**: Weak hook, unclear value, or too similar to recent posts
+Only queue A and B grade content. Rewrite C-grade or discard entirely.
+
+---
+
+## Phase 3 — Posting & Queue Management
+
+If `approval_mode` is ENABLED:
+1. Write generated posts to `linkedin_queue.json`
+2. Write a human-readable `linkedin_queue_preview.md` for review
+3. event_publish "linkedin_queue_updated" with queue size
+4. Do NOT post — wait for user approval
+
+If `approval_mode` is DISABLED:
+1. Post via the LinkedIn API (use newer Posts API):
+   ```
+   curl -s -X POST "https://api.linkedin.com/rest/posts" \
+     -H "Authorization: Bearer $LINKEDIN_ACCESS_TOKEN" \
+     -H "Content-Type: application/json" \
+     -d '{"author":"urn:li:person:MEMBER_ID","lifecycleState":"PUBLISHED","visibility":"PUBLIC","commentary":"Post content here"}'
+   ```
+   Note: LinkedIn is migrating from ugcPosts to the newer Posts API. Use /rest/posts endpoint. The author urn format: urn:li:person:{your-linkedin-id}
+2. Log each posted content to `linkedin_posted.json`
+
+---
+
+## Phase 4 — Engagement
+
+If `auto_engage` is enabled:
+1. Check your LinkedIn feed for relevant posts from connections
+2. Generate thoughtful comments that add value
+3. Like posts from people in your professional network
+4. NEVER leave generic comments — always add genuine insight
+
+---
+
+## Phase 5 — Performance Tracking
+
+Track metrics:
+- Post impressions and engagement rate
+- Comment engagement
+- Profile views (if available via API)
+- Connection request trends
+
+Analyze which content types and topics perform best.
+Store insights in knowledge graph for future optimization.
+
+### Session Exit Criteria
+Stop the current session when ANY of these conditions is met:
+1. **Queue full**: Approval queue has 10+ pending posts — stop generating until user reviews
+2. **API errors**: 3+ consecutive API failures — save state and alert user about token expiry
+3. **Engagement plateau**: Last 5 posts all had <1% engagement rate — pause and suggest strategy review
+4. **Iteration cap**: 15+ content generation iterations in a single session — save state and exit
+5. **Rate limited**: LinkedIn API returns 429 — back off and reschedule
+
+---
+
+## Phase 6 — State Persistence
+
+1. Save queue to `linkedin_queue.json`
+2. Save posting history to `linkedin_posted.json`
+3. memory_store `linkedin_hand_state`: last_run, posts_created, comments_sent
+4. Update dashboard stats:
+   - memory_store `linkedin_hand_posts_created` — total posts
+   - memory_store `linkedin_hand_comments_sent` — total comments
+   - memory_store `linkedin_hand_queue_size` — current queue size
+   - memory_store `linkedin_hand_engagement_rate` — average engagement rate
+
+---
+
+## Guidelines
+
+- ALWAYS maintain a professional tone — LinkedIn is a professional network
+- NEVER post controversial political or religious content
+- NEVER spam connections with messages or engagement
+- NEVER fabricate credentials, experience, or data
+- NEVER post content that could damage someone's professional reputation
+- Respect LinkedIn's API rate limits and Terms of Service
+- In `approval_mode` (default), ALWAYS write to queue — NEVER post without review
+- No external links in post body (put in first comment instead)
+- Focus on providing genuine value to your professional network
+- When in doubt about a post, queue it for review with a note
+"""
+
+[dashboard]
+[[dashboard.metrics]]
+label = "Posts Created"
+memory_key = "linkedin_hand_posts_created"
+format = "number"
+
+[[dashboard.metrics]]
+label = "Comments Sent"
+memory_key = "linkedin_hand_comments_sent"
+format = "number"
+
+[[dashboard.metrics]]
+label = "Queue Size"
+memory_key = "linkedin_hand_queue_size"
+format = "number"
+
+[[dashboard.metrics]]
+label = "Engagement Rate"
+memory_key = "linkedin_hand_engagement_rate"
+format = "percentage"
+
+[[dashboard.metrics]]
+label = "Profile Views"
+memory_key = "linkedin_hand_profile_views"
+format = "number"
@@ -0,0 +1,220 @@
+---
+name: linkedin-hand-skill
+version: "1.0.0"
+author: LibreFang
+description: "Expert knowledge for AI LinkedIn management -- API reference, content strategy, networking playbook, and professional engagement best practices"
+tags: [linkedin, social-media, professional, networking, content]
+runtime: prompt_only
+---
+
+# LinkedIn Management Expert Knowledge
+
+## LinkedIn API Reference
+
+### Authentication
+LinkedIn API uses OAuth 2.0 with bearer tokens.
+
+**Bearer Token**:
+```
+Authorization: Bearer $LINKEDIN_ACCESS_TOKEN
+```
+
+### Core Endpoints
+
+**Get authenticated user info**:
+```bash
+curl -s -H "Authorization: Bearer $LINKEDIN_ACCESS_TOKEN" \
+  -H "LinkedIn-Version: 202405" \
+  "https://api.linkedin.com/rest/userinfo"
+```
+
+**Create a text post (Posts API)**:
+```bash
+curl -s -X POST "https://api.linkedin.com/rest/posts" \
+  -H "Authorization: Bearer $LINKEDIN_ACCESS_TOKEN" \
+  -H "Content-Type: application/json" \
+  -H "LinkedIn-Version: 202405" \
+  -d '{
+    "author": "urn:li:person:MEMBER_ID",
+    "lifecycleState": "PUBLISHED",
+    "commentary": "Your post content here",
+    "visibility": "PUBLIC",
+    "distribution": {
+      "feedDistribution": "MAIN_FEED"
+    }
+  }'
+```
+
+**Comment on a post**:
+```bash
+curl -s -X POST "https://api.linkedin.com/rest/socialActions/URN/comments" \
+  -H "Authorization: Bearer $LINKEDIN_ACCESS_TOKEN" \
+  -H "Content-Type: application/json" \
+  -H "LinkedIn-Version: 202405" \
+  -d '{
+    "actor": "urn:li:person:MEMBER_ID",
+    "message": {"text": "Your comment here"}
+  }'
+```
+
+**Like a post**:
+```bash
+curl -s -X POST "https://api.linkedin.com/rest/socialActions/URN/likes" \
+  -H "Authorization: Bearer $LINKEDIN_ACCESS_TOKEN" \
+  -H "Content-Type: application/json" \
+  -H "LinkedIn-Version: 202405" \
+  -d '{
+    "actor": "urn:li:person:MEMBER_ID"
+  }'
+```
+
+### Rate Limits
+| Endpoint | Limit | Window |
+|----------|-------|--------|
+| Posts | 25 posts | 24 hours |
+| Comments | 10 comments | 1 minute |
+| Likes | 20 likes | 1 minute |
+| API calls (general) | 100 requests | 1 day |
+
+---
+
+## LinkedIn Content Strategy
+
+### The LinkedIn Algorithm (2024-2025)
+
+Key factors that affect reach:
+1. **Dwell time**: How long people spend reading your post
+2. **Early engagement**: Comments in the first hour boost distribution
+3. **Meaningful comments**: Long comments signal quality content
+4. **No external links**: Posts with links get 40-50% less reach
+5. **Personal stories**: Narrative content outperforms promotional content
+
+### Content Pillars
+
+Define 3-4 content pillars:
+```
+Example for a tech leader:
+  Pillar 1: Engineering Leadership (40%)
+  Pillar 2: Industry Trends & Analysis (30%)
+  Pillar 3: Career Growth & Mentoring (20%)
+  Pillar 4: Personal Lessons (10%)
+```
+
+### Post Formats That Work
+
+| Format | Avg Engagement | Best For |
+|--------|---------------|----------|
+| Personal story with lesson | High | Connection, authenticity |
+| Contrarian take | High | Discussion, visibility |
+| Step-by-step guide | Medium-High | Authority, saves |
+| Data + insight | Medium | Credibility |
+| Question/poll | Medium | Engagement |
+| Industry news + analysis | Medium | Thought leadership |
+
+### Optimal Posting Times (UTC-based)
+
+| Day | Best Times | Why |
+|-----|-----------|-----|
+| Tuesday | 8-10 AM | Peak professional engagement |
+| Wednesday | 8-10 AM | Mid-week content consumption |
+| Thursday | 8-10 AM, 12 PM | Second-best engagement day |
+| Monday | 8-10 AM | Start of work week |
+| Friday | 8-9 AM only | Engagement drops after morning |
+| Weekend | Avoid | 60-70% lower engagement |
+
+---
+
+## Post Writing Best Practices
+
+### The Hook (First 2 Lines)
+
+The first 2 lines appear before the "see more" fold. They must compel a click.
+
+Hooks that work:
+- **Bold statement**: "I fired my best employee last week. Here's why it was the right call."
+- **Surprising data**: "Only 3% of engineering managers do this. It changes everything."
+- **Confession**: "I made a $500K mistake in my first year as CTO."
+- **Question**: "Why do 90% of digital transformations fail?"
+- **Contrarian**: "Unpopular opinion: Stand-ups are a waste of time."
+
+### Writing Rules
+
+1. **One idea per post** -- don't try to cover everything
+2. **Short paragraphs** -- 1-2 sentences max, lots of white space
+3. **Use line breaks** -- make it scannable
+4. **End with a question** -- drives comments which boost reach
+5. **No links in the post body** -- put links in the first comment
+6. **3-5 relevant hashtags** -- at the bottom of the post
+7. **1000-1300 characters** -- sweet spot for engagement
+8. **Be authentic** -- personal stories outperform corporate speak
+
+### Comment Strategy
+
+When commenting on others' posts:
+- Add a new perspective or data point
+- Share a relevant personal experience
+- Ask a thoughtful follow-up question
+- Keep comments 2-4 sentences (meaningful but concise)
+- Avoid generic comments ("Great post!", "Thanks for sharing!")
+
+---
+
+## Networking Best Practices
+
+### Connection Requests
+- Always add a personal note (not the default message)
+- Reference something specific (their content, mutual connection, shared interest)
+- Keep it under 300 characters
+- Don't pitch in the connection request
+
+### Relationship Building
+- Consistently engage with connections' content before asking for anything
+- Share others' content with genuine commentary
+- Celebrate connections' achievements publicly
+- Offer help or resources without expecting anything in return
+
+---
+
+## Safety & Compliance
+
+### Content Guidelines
+NEVER post:
+- Confidential business information
+- Discriminatory or offensive content
+- False credentials or experience claims
+- Defamatory statements about competitors or individuals
+- Content that violates LinkedIn's Professional Community Policies
+- Misleading data or fabricated statistics
+
+### Content Moderation Rules
+
+Before posting any content, classify it:
+
+**Auto-REJECT** (never post):
+- Content containing hate speech, discrimination, or harassment
+- Unverified claims about competitors or individuals
+- Confidential or proprietary business information
+- Content that could be interpreted as financial or legal advice
+- Anything with profanity or inappropriate language
+- Political or religious debate content
+
+**Flag for REVIEW** (queue for human approval):
+- Controversial industry opinions or contrarian takes
+- Content mentioning specific companies or individuals by name
+- Posts discussing salary, compensation, or workplace issues
+- Content referencing current news events
+- Posts with strong emotional tone or personal vulnerability
+
+**Safe to POST** (can auto-publish if approval_mode is off):
+- Educational how-to content and professional tips
+- Industry trend analysis with cited sources
+- Career development advice and frameworks
+- Engagement posts (professional questions, polls)
+- Celebration of team or industry achievements
+
+### Professional Standards
+- Maintain professional tone even in casual posts
+- Fact-check all claims and statistics
+- Credit sources and tag collaborators
+- Disclose affiliations when discussing products or services
+- Respect intellectual property and copyright