@hienlh/ppm 0.9.81 → 0.9.83

package/.opencode/skills/social/SKILL.md

@@ -1,75 +0,0 @@
----
-name: ckm:social
-description: Social media content creation, scheduling, API integrations for X/Twitter, Facebook, Threads, LinkedIn, YouTube, TikTok, Instagram. Platform-specific workflows, engagement templates, hook writing.
-argument-hint: "[platform] [type] OR [schedule]"
-metadata:
-  author: claudekit
-  version: "2.0.0"
----
-
-# Social
-
-Social media content creation, scheduling, and platform management.
-
-<args>$ARGUMENTS</args>
-
-## When to Use
-
-- Social media post creation (any platform)
-- Content scheduling and calendar management
-- Platform-specific content optimization
-- Thread/carousel/reel creation
-- Engagement strategy and hook writing
-
-## Platforms
-
-`twitter`/`x`, `linkedin`, `instagram`, `tiktok`, `youtube`, `facebook`, `threads`
-
-## Content Types
-
-`post`, `thread`, `carousel`, `story`, `reel`
-
-## Workflow
-
-1. Parse platform + content type from `$ARGUMENTS`
-2. Use `social-media-manager` agent for platform best practices
-3. Use `content-creator` + `copywriter` agents for copy
-4. Platform-specific formatting + hashtag research
-5. Output to `assets/posts/{platform}/{date}-{slug}.md`
-
-## Subcommands
-
-| Subcommand | Description | Reference |
-|------------|-------------|-----------|
-| `schedule` | Schedule social media posts | `references/schedule.md` |
-
-## References (Knowledge Base)
-
-| Topic | File |
-|-------|------|
-| Platform Specs | `references/platform-specs.md` |
-| Hook Writing | `references/hook-writing.md` |
-| Engagement Templates | `references/engagement-templates.md` |
-| Thread Templates | `references/thread-templates.md` |
-| Posting Best Practices | `references/posting-best-practices.md` |
-| Rate Limits & Errors | `references/rate-limits-errors.md` |
-| Unified API Services | `references/unified-api-services.md` |
-| X/Twitter Workflow | `references/x-twitter-workflow.md` |
-| LinkedIn Workflow | `references/linkedin-workflow.md` |
-| Facebook Workflow | `references/facebook-workflow.md` |
-| Threads Workflow | `references/threads-workflow.md` |
-| TikTok Workflow | `references/tiktok-workflow.md` |
-| YouTube Workflow | `references/youtube-workflow.md` |
-
-## Scripts
-
-| Script | Purpose |
-|--------|---------|
-| `scripts/schedule-post.js` | Schedule posts via API |
-| `scripts/validate-post-content.js` | Validate post content against platform rules |
-
-## Routing
-
-1. Parse subcommand from `$ARGUMENTS` (first word)
-2. Load corresponding `references/{subcommand}.md`
-3. Execute with remaining arguments

package/.opencode/skills/social/references/engagement-templates.md

@@ -1,58 +0,0 @@
-# Engagement Templates
-
-## Engagement Hook Types
-
-### Questions
-- "What's your biggest challenge with [topic]?"
-- "How do you handle [situation]?"
-- "What would you do if [scenario]?"
-- "Which [option] do you prefer and why?"
-
-### Polls/Surveys
-- "Quick poll: [Option A] or [Option B]?"
-- "What's your priority this [timeframe]?"
-- "Rate your [skill] from 1-10"
-
-### This or That
-- "[Option A] or [Option B]?"
-- "Early bird or night owl?"
-- "[Tool A] vs [Tool B]?"
-
-### Fill in the Blank
-- "The best advice I ever received was _____"
-- "I wish I knew _____ when I started [activity]"
-- "My unpopular opinion about [topic] is _____"
-
-### Hot Takes
-- "Unpopular opinion: [statement]"
-- "Hot take: [controversial stance]"
-- "Agree or disagree: [statement]"
-
-## Response Templates
-
-### Positive Engagement
-- "Great point! What made you think of that?"
-- "This is exactly right. I'd add [insight]"
-- "Love this perspective. Have you tried [suggestion]?"
-
-### Adding Value
-- "Here's a resource that might help: [link]"
-- "I wrote about this recently: [link]"
-- "Quick tip: [actionable advice]"
-
-### Starting Conversations
-- "Interesting! Tell me more about [aspect]"
-- "How did you get into [topic]?"
-- "What's your experience with this?"
-
-## Community Building
-
-### Acknowledgment
-- Celebrate wins: "Congrats on [achievement]!"
-- Show appreciation: "Thanks for sharing this!"
-- Welcome newcomers: "Great to have you here!"
-
-### Collaboration Hooks
-- "Looking for [type of person] to [collaborate on]"
-- "Who wants to do a [challenge/project] together?"
-- "Tag someone who needs to see this"

package/.opencode/skills/social/references/facebook-workflow.md

@@ -1,175 +0,0 @@
-# Facebook API Workflow
-
-Graph API v20.0 for Facebook Pages. OAuth 2.0 authentication.
-
-## Required Scopes
-
-```javascript
-const scopes = [
-  'pages_show_list',
-  'business_management',
-  'pages_manage_posts',
-  'pages_manage_engagement',
-  'pages_read_engagement',
-  'read_insights'
-];
-```
-
-## OAuth Flow
-
-```typescript
-// 1. Generate auth URL
-const authUrl = `https://www.facebook.com/v20.0/dialog/oauth?` +
-  `client_id=${FACEBOOK_APP_ID}&` +
-  `redirect_uri=${encodeURIComponent(redirectUri)}&` +
-  `state=${state}&scope=${scopes.join(',')}`;
-
-// 2. Exchange code for short-lived token
-const tokenResponse = await fetch(
-  `https://graph.facebook.com/v20.0/oauth/access_token?` +
-  `client_id=${FACEBOOK_APP_ID}&redirect_uri=${redirectUri}&` +
-  `client_secret=${FACEBOOK_APP_SECRET}&code=${code}`
-);
-
-// 3. Exchange for long-lived token (59 days)
-const longLivedToken = await fetch(
-  `https://graph.facebook.com/v20.0/oauth/access_token?` +
-  `grant_type=fb_exchange_token&client_id=${FACEBOOK_APP_ID}&` +
-  `client_secret=${FACEBOOK_APP_SECRET}&fb_exchange_token=${shortToken}`
-);
-```
-
-## Get User & Pages
-
-```typescript
-// Get user info
-const user = await fetch(
-  `https://graph.facebook.com/v20.0/me?fields=id,name,picture&access_token=${token}`
-).then(r => r.json());
-
-// Get pages
-const { data: pages } = await fetch(
-  `https://graph.facebook.com/v20.0/me/accounts?fields=id,username,name,picture.type(large)&access_token=${token}`
-).then(r => r.json());
-
-// Get page access token
-const { access_token: pageToken, id, name, picture } = await fetch(
-  `https://graph.facebook.com/v20.0/${pageId}?fields=username,access_token,name,picture.type(large)&access_token=${token}`
-).then(r => r.json());
-```
-
-## Post Creation
-
-```typescript
-// Text post with optional link
-const post = await fetch(
-  `https://graph.facebook.com/v20.0/${pageId}/feed?access_token=${pageToken}&fields=id,permalink_url`,
-  {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({
-      message: 'Post content',
-      link: 'https://example.com', // optional link preview
-      published: true
-    })
-  }
-).then(r => r.json());
-
-// Post URL: permalink_url
-```
-
-## Photo Upload
-
-```typescript
-// 1. Upload photos (unpublished)
-const photoIds = await Promise.all(
-  mediaUrls.map(async (url) => {
-    const { id } = await fetch(
-      `https://graph.facebook.com/v20.0/${pageId}/photos?access_token=${pageToken}`,
-      {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({ url, published: false })
-      }
-    ).then(r => r.json());
-    return { media_fbid: id };
-  })
-);
-
-// 2. Create post with photos
-const post = await fetch(
-  `https://graph.facebook.com/v20.0/${pageId}/feed?access_token=${pageToken}&fields=id,permalink_url`,
-  {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({
-      message: 'Multi-photo post',
-      attached_media: photoIds,
-      published: true
-    })
-  }
-).then(r => r.json());
-```
-
-## Video/Reels Upload
-
-```typescript
-const video = await fetch(
-  `https://graph.facebook.com/v20.0/${pageId}/videos?access_token=${pageToken}&fields=id,permalink_url`,
-  {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({
-      file_url: videoUrl,
-      description: 'Video description',
-      published: true
-    })
-  }
-).then(r => r.json());
-
-// Reel URL format: https://www.facebook.com/reel/{videoId}
-```
-
-## Comments
-
-```typescript
-const comment = await fetch(
-  `https://graph.facebook.com/v20.0/${postId}/comments?access_token=${pageToken}&fields=id,permalink_url`,
-  {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({
-      message: 'Comment text',
-      attachment_url: imageUrl // optional image
-    })
-  }
-).then(r => r.json());
-```
-
-## Analytics
-
-```typescript
-const { data } = await fetch(
-  `https://graph.facebook.com/v20.0/${pageId}/insights?` +
-  `metric=page_impressions_unique,page_post_engagements,page_daily_follows,page_video_views&` +
-  `access_token=${pageToken}&period=day&since=${since}&until=${until}`
-).then(r => r.json());
-```
-
-## Common Errors
-
-| Code | Meaning | Action |
-|------|---------|--------|
-| `490` | Token expired | Re-authenticate |
-| `REVOKED_ACCESS_TOKEN` | User revoked | Re-authenticate |
-| `1366046` | Image too large | Max 4MB, JPG/PNG only |
-| `1390008` | Posting too fast | Slow down |
-| `1346003` | Abusive content | Review content |
-| `1404078` | Auth required | Re-authorize page |
-| `1609008` | Facebook.com link | Can't post FB links |
-
-## Rate Limits
-
-- Max concurrent: 100 jobs
-- Token refresh: ~59 days lifespan
-- Photo size: Max 4MB

package/.opencode/skills/social/references/hook-writing.md

@@ -1,190 +0,0 @@
-# Hook Writing Guide
-
-Stop the scroll. Capture attention in the first 3 seconds.
-
-## Why Hooks Matter
-
-- 63% of high-CTR videos hook viewers within 3 seconds (TikTok for Business)
-- Average human attention span: 8.25 seconds (25% decrease over 20 years)
-- Hook determines whether content gets consumed or scrolled past
-
-## Hook Psychology
-
-### Cognitive Triggers
-
-| Trigger | How It Works | Example |
-|---------|--------------|---------|
-| Curiosity Gap | Open loop that demands closure | "The reason your content fails isn't what you think" |
-| Pattern Interrupt | Unexpected statement breaks autopilot | "Stop creating content. Start this instead." |
-| Specificity | Concrete numbers feel credible | "I made $47,293 in 30 days using this" |
-| Social Proof | Others validate the claim | "Why 10,000+ marketers use this daily" |
-| Loss Aversion | Fear of missing out/losing | "This mistake is costing you $1000/month" |
-
-## Hook Formulas by Type
-
-### Curiosity Hooks
-
-```
-"What if I told you there's a simple way to [DESIRED RESULT]?"
-"Why doesn't anyone talk about [RELATED TO NICHE]?"
-"This will change the way you [ACTION]"
-"The dark secret behind [RELATED TO NICHE]"
-"Everything you knew about [TOPIC] is wrong"
-```
-
-### Problem-Solution Hooks
-
-```
-"Struggling with [PAIN POINT]? Here's a secret tip I wish I knew earlier"
-"Why 99% of [TARGET AUDIENCE] fail at [TOPIC]"
-"This one mistake could be costing you [NUMBER]"
-"If you're tired of [PAIN POINT], try this"
-"[NUMBER] signs your [THING] isn't working"
-```
-
-### Authority/Experience Hooks
-
-```
-"How I went from [PAST] to [RESULT] in [TIME]"
-"I tried every [SOLUTION] so you don't have to"
-"[HACK] I wish I knew earlier"
-"Steal my secret strategy on [TOPIC]"
-"If I had to start all over again..."
-```
-
-### List-Based Hooks
-
-```
-"[NUMBER] steps to [DESIRED RESULT]"
-"[NUMBER] mistakes you're probably making"
-"[NUMBER] things about [NICHE] I wish I knew earlier"
-"Here's [NUMBER] underestimated [TIPS] to [RESULT]"
-```
-
-### Experimental/Proof Hooks
-
-```
-"What happens when we [ACTION]?"
-"Let's figure out why [PROBLEM]"
-"I tested this for 30 days. Here's what happened."
-```
-
-## Platform-Specific Hooks
-
-### Twitter/X (280 chars)
-
-**Best patterns:**
-- Thread openers with curiosity gap
-- Contrarian takes
-- Hot takes with qualifiers
-
-**Examples:**
-```
-"Unpopular opinion: [CONTRARIAN VIEW]"
-"I spent 5 years learning [TOPIC]. Here's everything in one thread:"
-"[THING] is overrated. Here's what actually works:"
-```
-
-### LinkedIn (Professional)
-
-**Best patterns:**
-- Data-driven insights
-- Professional storytelling
-- Thought leadership
-
-**Examples:**
-```
-"After interviewing 100 [ROLE], I noticed a pattern..."
-"[STATISTIC] of [AUDIENCE] struggle with [PROBLEM]. Here's why:"
-"The best [ROLE] I know all do this one thing differently:"
-```
-
-### TikTok/Reels (3-second rule)
-
-**Best patterns:**
-- Visual + verbal hooks
-- Bold claims
-- Tension words (dangerous, secret, illegal)
-
-**Examples:**
-```
-"POV: You just discovered [GAME-CHANGER]"
-"These 3 [TIPS] feel illegal to know"
-"Stop scrolling if you [TARGET AUDIENCE IDENTIFIER]"
-```
-
-### Instagram Carousel
-
-**First slide hooks:**
-```
-"Save this before it's gone"
-"The [TOPIC] cheat sheet you need"
-"[NUMBER] things no one tells you about [TOPIC]"
-```
-
-## Anti-Patterns (What to Avoid)
-
-### Clickbait Language
-
-**DON'T use:**
-- "You won't BELIEVE..."
-- "SHOCKING!"
-- "This is INSANE!"
-- "MIND-BLOWING!"
-- "Everyone's talking about..."
-
-**Why:** Erodes trust. Algorithms penalize engagement bait.
-
-### Punching Keywords
-
-**DON'T:**
-- ALL CAPS for emphasis
-- Excessive exclamation marks!!!
-- Emoji spam in hooks
-
-**Why:** Signals low-quality content. Professional audience scrolls past.
-
-### Empty Promises
-
-**DON'T:**
-- Promise results you can't deliver
-- Overhype mediocre content
-- Use vague superlatives ("best ever", "game-changing")
-
-**Why:** High bounce rate hurts reach. Damages credibility.
-
-### Slow Starts
-
-**DON'T:**
-- "Hey guys, so today I wanted to talk about..."
-- Long intros before value
-- Explaining why you're making the content
-
-**Why:** You have 3 seconds. Get to the point.
-
-## Hook Quality Checklist
-
-- [ ] Delivers value promise in first 3 seconds
-- [ ] Targets specific audience pain point or desire
-- [ ] Uses concrete numbers where applicable
-- [ ] Creates open loop (curiosity gap)
-- [ ] Matches content that follows (no bait-and-switch)
-- [ ] Avoids clickbait/punching keywords
-- [ ] Works without sound (for silent scrolling)
-
-## Hook Testing Framework
-
-1. **Create 3-5 hook variants** for same content
-2. **Test on platform** (Stories, A/B test tools)
-3. **Measure:**
-   - Watch time / read time
-   - Completion rate
-   - Save/share rate (not just likes)
-4. **Iterate** based on data
-
-## Integration
-
-Use these formulas with:
-- `copywriting` skill - For body copy that delivers on hook promise
-- `social` skill - For platform-specific formatting
-- `/youtube:social` command - Applies hooks to video content

package/.opencode/skills/social/references/linkedin-workflow.md

@@ -1,162 +0,0 @@
-# LinkedIn API Workflow
-
-OAuth 2.0 with REST API v2. Supports personal profiles and company pages.
-
-## OAuth Flow
-
-```typescript
-const scopes = [
-  'openid', 'profile', 'w_member_social', 'r_basicprofile',
-  'rw_organization_admin', 'w_organization_social', 'r_organization_social'
-];
-
-// Auth URL
-const authUrl = `https://www.linkedin.com/oauth/v2/authorization?` +
-  `response_type=code&client_id=${LINKEDIN_CLIENT_ID}&` +
-  `redirect_uri=${encodeURIComponent(redirectUri)}&` +
-  `scope=${encodeURIComponent(scopes.join(' '))}`;
-
-// Exchange code for tokens
-const tokenResponse = await fetch('https://www.linkedin.com/oauth/v2/accessToken', {
-  method: 'POST',
-  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
-  body: new URLSearchParams({
-    grant_type: 'authorization_code',
-    code, redirect_uri, client_id, client_secret
-  })
-});
-const { access_token, refresh_token, expires_in } = await tokenResponse.json();
-
-// Refresh token
-const refreshResponse = await fetch('https://www.linkedin.com/oauth/v2/accessToken', {
-  method: 'POST',
-  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
-  body: new URLSearchParams({
-    grant_type: 'refresh_token', refresh_token, client_id, client_secret
-  })
-});
-```
-
-## Media Upload (Images/Videos/PDFs)
-
-```typescript
-// 1. Initialize upload
-const initResponse = await fetch(`https://api.linkedin.com/rest/images?action=initializeUpload`, {
-  method: 'POST',
-  headers: {
-    'Content-Type': 'application/json',
-    'X-Restli-Protocol-Version': '2.0.0',
-    'LinkedIn-Version': '202511',
-    Authorization: `Bearer ${accessToken}`
-  },
-  body: JSON.stringify({
-    initializeUploadRequest: {
-      owner: `urn:li:person:${personId}` // or urn:li:organization:${orgId}
-    }
-  })
-});
-const { value: { uploadUrl, image } } = await initResponse.json();
-
-// 2. Upload media
-await fetch(uploadUrl, {
-  method: 'PUT',
-  headers: { 'X-Restli-Protocol-Version': '2.0.0', 'LinkedIn-Version': '202511' },
-  body: imageBuffer
-});
-
-// For videos, use chunked upload (2MB chunks) and finalize
-await fetch('https://api.linkedin.com/rest/videos?action=finalizeUpload', {
-  method: 'POST',
-  body: JSON.stringify({ finalizeUploadRequest: { video: videoUrn, uploadToken: '', uploadedPartIds: etags } })
-});
-```
-
-## Post Creation
-
-```typescript
-// Text escaping required for special characters
-const fixText = (text) => text
-  .replace(/\\/g, '\\\\').replace(/</g, '\\<').replace(/>/g, '\\>')
-  .replace(/#/g, '\\#').replace(/@/g, '\\@').replace(/\[/g, '\\[')
-  .replace(/]/g, '\\]').replace(/\*/g, '\\*').replace(/\(/g, '\\(')
-  .replace(/\)/g, '\\)');
-// Note: Preserve @[Name](urn:li:organization:ID) mentions
-
-// Create post
-const response = await fetch('https://api.linkedin.com/rest/posts', {
-  method: 'POST',
-  headers: {
-    'LinkedIn-Version': '202511',
-    'X-Restli-Protocol-Version': '2.0.0',
-    'Content-Type': 'application/json',
-    Authorization: `Bearer ${accessToken}`
-  },
-  body: JSON.stringify({
-    author: `urn:li:person:${id}`, // or urn:li:organization:${id}
-    commentary: fixText(message),
-    visibility: 'PUBLIC',
-    distribution: { feedDistribution: 'MAIN_FEED', targetEntities: [], thirdPartyDistributionChannels: [] },
-    content: { media: { id: mediaUrn } }, // single media
-    // OR for multiple images: content: { multiImage: { images: mediaIds.map(id => ({ id })) } }
-    lifecycleState: 'PUBLISHED',
-    isReshareDisabledByAuthor: false
-  })
-});
-const postId = response.headers.get('x-restli-id');
-```
-
-## PDF Carousel (Images as PDF)
-
-Convert multiple images to PDF for carousel posts:
-```typescript
-import imageToPDF from 'image-to-pdf';
-const pdfBuffer = await imageToPDF(imageBuffers, [width, height]);
-// Upload as document type, add title: 'slides.pdf' in content
-```
-
-## Comments
-
-```typescript
-await fetch(`https://api.linkedin.com/v2/socialActions/${encodeURIComponent(postId)}/comments`, {
-  method: 'POST',
-  headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${token}` },
-  body: JSON.stringify({
-    actor: `urn:li:person:${id}`,
-    object: postId,
-    message: { text: fixText(comment) }
-  })
-});
-```
-
-## Company Page Lookup
-
-```typescript
-// Get company from vanity URL
-const { elements } = await fetch(
-  `https://api.linkedin.com/v2/organizations?q=vanityName&vanityName=${vanity}`,
-  { headers: { 'X-Restli-Protocol-Version': '2.0.0', 'LinkedIn-Version': '202511', Authorization: `Bearer ${token}` } }
-).then(r => r.json());
-// Mention format: @[Company Name](urn:li:organization:123456)
-```
-
-## Repost
-
-```typescript
-await fetch('https://api.linkedin.com/rest/posts', {
-  method: 'POST',
-  headers: { /* same as post */ },
-  body: JSON.stringify({
-    author: `urn:li:person:${id}`,
-    commentary: '',
-    visibility: 'PUBLIC',
-    lifecycleState: 'PUBLISHED',
-    reshareContext: { parent: originalPostUrn }
-  })
-});
-```
-
-## Rate Limits
-
-- Max concurrent: 2 jobs recommended
-- Refresh required (tokens expire)
-- Use `refreshWait` pattern for reliability