Skip to content

slayerman420/mimiq

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

10 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸͺž Mimiq β€” Claude Skills for Social Media

Mimiq builds your personal social media system β€” capturing your writing voice, auditing your best content, and ghostwriting posts that sound exactly like you.

Built by @slayerman420


What It Does

Skill Purpose
social-suite Master orchestrator β€” start here
voice-capture Scrapes your profiles + interviews you to build a Style Fingerprint
content-audit Finds your top-performing topics, formats, and best posting times
post-strategist Ghostwrites full posts in your voice + recommends when to publish
mimiq-memory Persistent memory, feedback system, multi-profile identity, community insights

How It Works

You β†’ /social-suite β†’ voice-capture β†’ content-audit β†’ post-strategist β†’ ready to publish
                            ↓                ↓                ↓
                       mimiq-memory ←————————————————————————— saves everything

voice-capture scrapes your public profiles (Medium, Substack, Reddit, X) via Firecrawl, then conducts a dynamic interview to build a precise Style Fingerprint. Falls back to manual paste for closed platforms (LinkedIn, Facebook, Instagram).

content-audit pulls public engagement data to find your top posts, winning topics, and best times to publish. Manual input fallback for closed platforms.

post-strategist ghostwrites complete posts using your fingerprint. Offers two timing modes: your personal historical best times, and platform research-backed best times.

mimiq-memory runs at the start and end of every session. Stores all scrapes, fingerprints, audits, and ghostwritten posts in a local database at ~/.claude/mimiq-memory/. Links multiple social handles to one identity. Lets you rate every post (perfect / close / off), correct audits, and give feedback that improves your fingerprint over time. Includes an opt-in community insights layer that surfaces anonymized patterns from other Mimiq users.


Supported Platforms

Platform Voice Capture Engagement Data
X/Twitter βœ… Apify (apidojo/twitter-scraper-lite) βœ… Apify (apidojo/tweet-scraper)
Reddit βœ… Apify (trudax/reddit-scraper) βœ… Apify (trudax/reddit-scraper)
Instagram βœ… Apify (apify/instagram-scraper) βœ… Apify (apify/instagram-scraper)
Facebook βœ… Apify (apify/facebook-posts-scraper) βœ… Apify (apify/facebook-posts-scraper)
LinkedIn ⚠️ Apify (harvestapi/linkedin-profile-scraper) ⚠️ Limited (manual fallback)
Medium βœ… Web fetch (no actor needed) βœ… Web fetch
Substack βœ… Web fetch (no actor needed) βœ… Web fetch

⚠️ = Actor available but platform limits public data. Manual paste fallback applies.


Requirements

  • Claude Code or Claude.ai (Pro)
  • Apify MCP connected to Claude β€” for scraping all platforms via Actors
  • An Apify account with the required Actors installed (see table below)

Mimiq works without Apify, but you will need to paste content manually for all platforms.

Required Apify Actors

Each platform uses a specific Apify Actor. Install them from the Apify Store before running voice-capture or content-audit. One Apify account runs all actors β€” they bill independently.

Platform Actor ID Used For
X/Twitter apidojo/twitter-scraper-lite Voice capture
X/Twitter apidojo/tweet-scraper Engagement audit
Reddit trudax/reddit-scraper Voice capture + audit
Instagram apify/instagram-scraper Voice capture + audit
Facebook apify/facebook-posts-scraper Voice capture + audit
LinkedIn harvestapi/linkedin-profile-scraper Voice capture + audit
Medium (web fetch β€” no actor needed) Voice capture + audit
Substack (web fetch β€” no actor needed) Voice capture + audit

Browse and install actors at apify.com/store. Search by actor ID. LinkedIn and Facebook public engagement data is limited β€” expect manual input fallback for those.


Installation

Claude Code (CLI) β€” One-Command Install

curl -fsSL https://raw.githubusercontent.com/slayerman420/mimiq/main/install.sh | bash

This installs all four skills to ~/.claude/skills/ and makes them available in every Claude Code session.

Or manually:

git clone https://github.com/slayerman420/mimiq.git
cd mimiq
./install.sh

Claude.ai Chat / Cowork β€” Manual Upload Required

⚠️ There is no auto-installer for Chat or Cowork. These are cloud-based and can't read from your computer's filesystem, so skills must be uploaded manually through the UI. This is a Claude platform limitation, not specific to Mimiq.

  1. Download all four .skill files from the dist/ folder:
  2. Open Claude β†’ Settings β†’ Skills β†’ Personal Skills
  3. Click + and upload each .skill file one by one
  4. All four should appear under Personal Skills with the toggle turned on

πŸ’‘ If you're a Claude Code user too, the CLI install above is completely separate β€” you'll need to do both if you want Mimiq everywhere.


Usage

Claude Code

/social-suite          Full setup β€” start here
/voice-capture         Capture your writing style
/content-audit         Analyze your best content
/post-strategist       Ghostwrite posts in your voice

Claude.ai Chat / Cowork

Skills trigger automatically. Just say:

"Help me set up my social media system" "Write a LinkedIn post in my voice" "What are my best performing topics?" "Draft a week of content for me"


Uninstall

./uninstall.sh

Or manually:

rm -rf ~/.claude/skills/social-suite
rm -rf ~/.claude/skills/voice-capture
rm -rf ~/.claude/skills/content-audit
rm -rf ~/.claude/skills/post-strategist

File Structure

mimiq/
β”œβ”€β”€ install.sh                     # One-command installer
β”œβ”€β”€ uninstall.sh                   # Clean uninstaller
β”œβ”€β”€ README.md
β”œβ”€β”€ LICENSE
β”œβ”€β”€ CHANGELOG.md
β”œβ”€β”€ skills/                        # Skill source files
β”‚   β”œβ”€β”€ social-suite/SKILL.md
β”‚   β”œβ”€β”€ voice-capture/SKILL.md
β”‚   β”œβ”€β”€ content-audit/SKILL.md
β”‚   β”œβ”€β”€ post-strategist/SKILL.md
β”‚   └── mimiq-memory/
β”‚       β”œβ”€β”€ SKILL.md
β”‚       β”œβ”€β”€ references/schema.md
β”‚       └── scripts/               # 13 Python scripts for memory, feedback, queries
└── dist/                          # Packaged .skill files for Claude.ai upload
    β”œβ”€β”€ social-suite.skill
    β”œβ”€β”€ voice-capture.skill
    β”œβ”€β”€ content-audit.skill
    β”œβ”€β”€ post-strategist.skill
    └── mimiq-memory.skill

Contributing

Open an issue before submitting a PR for major changes.

Ideas for future skills:

  • hashtag-strategist β€” optimal hashtags per platform
  • repurpose-engine β€” one post β†’ all platforms
  • engagement-tracker β€” track performance over time

License

CC BY-NC 4.0 β€” Free to use and modify. Not for commercial use. Credit required.

Β© 2026 slayerman420

About

πŸͺž Claude skills that capture your writing voice and ghostwrite social media posts that sound exactly like you.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors