Neckr0ik Socialposter

Automate social media posting across Twitter, LinkedIn, Facebook, Instagram. Schedule posts, track engagement, auto-reply. Use when you need to manage social...

Security Scan

The skill's documentation describes a CLI and code (scripts, config, OAuth tokens) but the package contains no binaries, no install instructions, and declares no required credentials — the pieces don't line up.

Purpose & Capability

The SKILL.md describes a full-featured CLI (neckr0ik-socialposter), references scripts (scripts/social.py) and reference docs, and explains how to set API credentials for Twitter/LinkedIn/etc., but the published skill contains no code files, no binaries, no install spec, and declares no required environment variables. A social-posting skill would normally include either an install step, a packaged binary/library, or explicit requirements for API credentials — those are missing here.

Instruction Scope

The runtime instructions expect the agent/user to run a local CLI, manage configuration, and manipulate local files (e.g., ${day}-content.txt, replies.yaml, references/*). There are no instructions that tell how to obtain or install that CLI or how the agent should handle OAuth flows. The instructions do not ask the agent to read unrelated system secrets, but they assume access to local files and a CLI that are absent from the package.

Install Mechanism

There is no install specification and no shipped code. Yet SKILL.md references an executable and scripts. This mismatch means the skill cannot function as described out of the box and could mislead an agent into attempting to run commands that do not exist. Absence of an install mechanism when one is clearly needed is a red flag.

Credentials

The documentation shows the skill requires platform API keys/tokens (twitter.api_key, twitter.api_secret, linkedin.access_token) and persistent configuration, but the registry metadata declares no required environment variables or primary credential. The skill should have declared what secrets it needs and how it expects them to be supplied; the omission is inconsistent and could confuse users about where to provide sensitive credentials.

Persistence & Privilege

The skill does not request always:true, does not declare system-wide config modifications, and is not forcing autonomous inclusion. No elevated persistence or cross-skill modification is indicated in the metadata.

What to consider before installing

This package looks incomplete or improperly published: the SKILL.md expects a local CLI, scripts, and API credentials, but the skill bundle contains no code, no install instructions, and declares no required credentials. Before installing or using it, ask the publisher for: (1) the source code or a trustworthy homepage, (2) a clear install method (package/binary or repository), (3) an explanation of how credentials are handled (OAuth vs. direct tokens) and what exact env vars/permissions are needed, and (4) the referenced files (scripts/social.py, references/*). Do not supply API keys or tokens to this skill until you can verify its code and origin. If you can't obtain those assurances, avoid using it or only run it in an isolated/test environment with throwaway accounts.

Social Media Automation

Multi-platform social media automation.

What This Does

• Post Scheduling — Schedule posts for optimal times
• Multi-Platform — Twitter, LinkedIn, Facebook, Instagram
• Content Calendar — Plan weeks/months ahead
• Auto-Reply — Respond to mentions automatically
• Analytics — Track engagement and growth

Quick Start

# Schedule a tweet
neckr0ik-socialposter post --platform twitter --content "Hello world!" --schedule "2026-03-07 09:00"

# Schedule multi-platform post
neckr0ik-socialposter post --platform twitter,linkedin --content "Blog post alert!" --schedule "2026-03-07 10:00"

# View scheduled posts
neckr0ik-socialposter calendar --days 7

# Auto-reply to mentions
neckr0ik-socialposter auto-reply --platform twitter --keywords "thanks,thank you" --response "You're welcome!"

Supported Platforms

Platform	Post	Schedule	Reply	Analytics
Twitter/X	✅	✅	✅	✅
LinkedIn	✅	✅	✅	✅
Facebook	✅	✅	✅	✅
Instagram	✅	✅	🟡	✅
Threads	✅	✅	✅	🟡
Bluesky	✅	✅	✅	🟡

Commands

post

Create and schedule posts.

neckr0ik-socialposter post [options]

Options:
  --platform <list>     Comma-separated platforms (twitter,linkedin,facebook,instagram)
  --content <text>      Post content
  --media <files>       Media files to attach
  --schedule <datetime> Schedule time (ISO format)
  --timezone <tz>       Timezone for schedule

calendar

View scheduled posts.

neckr0ik-socialposter calendar [options]

Options:
  --days <n>            Days to show (default: 7)
  --platform <name>      Filter by platform
  --status <status>     Filter by status (scheduled, posted, failed)

auto-reply

Set up automatic replies.

neckr0ik-socialposter auto-reply [options]

Options:
  --platform <name>     Platform name
  --keywords <list>    Trigger keywords (comma-separated)
  --response <text>     Response template
  --probability <n>     Probability of replying (0-1)

analytics

View engagement analytics.

neckr0ik-socialposter analytics [options]

Options:
  --platform <name>     Platform name
  --period <days>        Time period (default: 30)
  --export <format>     Export format (csv, json)

connect

Connect social media accounts.

neckr0ik-socialposter connect --platform <name>

Content Calendar

Plan your content ahead:

# Add to calendar
neckr0ik-socialposter calendar add --content "Monday motivation" --platform twitter --day monday --time 09:00
neckr0ik-socialposter calendar add --content "Tech tip" --platform linkedin --day wednesday --time 14:00
neckr0ik-socialposter calendar add --content "Weekend vibes" --platform instagram --day friday --time 17:00

# View weekly calendar
neckr0ik-socialposter calendar view --week

Auto-Reply Templates

Create smart auto-replies:

# replies.yaml
- name: thanks-reply
  platform: twitter
  keywords:
    - thanks
    - thank you
    - appreciation
  response: "You're welcome! 🙏"
  probability: 0.8
  
- name: question-reply
  platform: linkedin
  keywords:
    - how do
    - how to
    - what is
  response: "Great question! Check out our FAQ: [link]"
  probability: 0.5
  
- name: support-reply
  platform: all
  keywords:
    - help
    - support
    - issue
  response: "I've noted your concern. Our team will reach out shortly."
  probability: 1.0

Optimal Posting Times

Get recommended posting times:

neckr0ik-socialposter optimize --platform twitter

# Output:
# Best times to post on Twitter:
#   Monday: 09:00, 12:00, 17:00
#   Tuesday: 10:00, 13:00, 18:00
#   Wednesday: 09:00, 12:00, 15:00
#   ...

Engagement Tracking

# Track post engagement
neckr0ik-socialposter track --post-id <id>

# Track account growth
neckr0ik-socialposter growth --platform twitter --days 30

# Compare platforms
neckr0ik-socialposter compare --days 30

Rate Limits

The skill respects platform rate limits:

Platform	Posts/Day	DMs/Day
Twitter	2,400	1,000
LinkedIn	100	30
Facebook	25	-
Instagram	25	50

Configuration

# Set API credentials
neckr0ik-socialposter config set twitter.api_key <key>
neckr0ik-socialposter config set twitter.api_secret <secret>
neckr0ik-socialposter config set linkedin.access_token <token>

# Set default timezone
neckr0ik-socialposter config set timezone "America/Mexico_City"

Use Cases

1. Content Calendar

Plan and schedule a week of posts:

# Create daily posts for a week
for day in monday tuesday wednesday thursday friday; do
  neckr0ik-socialposter post \
    --platform twitter,linkedin \
    --content "$(cat ${day}-content.txt)" \
    --schedule "2026-03-${day_num} 09:00"
done

2. Auto-Engagement

Automatically engage with your audience:

# Auto-thank for mentions
neckr0ik-socialposter auto-reply \
  --platform twitter \
  --keywords "mentioned,recommended,recommended" \
  --response "Thanks for the mention! 🙏"

3. Analytics Report

Generate monthly report:

neckr0ik-socialposter analytics --period 30 --export csv > monthly-report.csv

See Also

• references/platforms.md — Platform-specific notes
• references/rate-limits.md — Rate limit details
• scripts/social.py — Main implementation