agentsclimarketplace

Postking reddit

Skill bitsandtea/postking-skills/skills/postking-reddit

Teach any AI agent to run your content marketing. Open-source skill for PostKing - generate posts, plan content weeks, ship blog articles, build landing pages - installable in Hermes, Claude, and Codex.

Install
npx -y skills add bitsandtea/postking-skills --skill postking-reddit

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Build a fit-scored subreddit pool for a brand, match content to the best communities with posting angles, and natively rewrite a post for a specific subreddit before a human posts it.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

6.3 KB, as published. Nobody here has run it

Reddit Growth

Grow a brand's presence on Reddit the way Reddit actually rewards: find the communities that fit, match a specific piece of content to the best ones with a tailored angle, and rewrite it in native Reddit voice — then hand it to the human to review and post.

When to Use

Use this skill when a user wants to find subreddits that fit their brand, match an existing piece of content (blog post, post draft) to the best-fit communities with a posting angle, or get a Reddit-native rewrite of content before posting it themselves.

When NOT to Use

Not for automatically publishing to Reddit — PostKing never posts on the brand's behalf; this skill only prepares review-ready drafts. Not for other-platform content generation or scheduling — that's postking-social/postking. Not for applying a saved voice profile in general — that's postking-brand-voice (this skill only consumes a voiceId from it).

Minimal tool subset

This skill needs only these tools out of PostKing's 200+:

  • reddit_generate_pool — crawl Reddit and build the brand's fit-scored subreddit pool (async).
  • reddit_get_pool — read the saved pool, sorted most-relevant first; each row includes posting_style and no_promotion_reason.
  • reddit_suggest — match a piece of content to up to 8 best-fit subreddits with posting angles (sync, 0 credits).
  • reddit_rewrite — natively rewrite a post for a specific subreddit, optionally in a saved voice.
  • reddit_list_posts — list previously rewritten Reddit posts.
  • list_voices — get a voiceId to pass into reddit_rewrite.
  • get_job — poll reddit_generate_pool.

Optional: reddit_global_pool — informational stats on the global known-subreddit dataset (not brand-specific). get_post — fallback poll if reddit_rewrite times out and returns a postId instead of a finished draft.

Prerequisites

  1. Authenticated with credits — see the postking-getting-started skill.
  2. A brand already onboarded — see the postking-getting-started skill.

Procedure

"Find subreddits for us and turn this blog post into a Reddit post."

Async tools return { operationId, status } — poll get_job({ operationId }) until state is completed, failed, partially_failed, or cancelled.

  1. Build the pool. reddit_generate_pool({ brandId }) → async, poll get_job. Crawls Reddit and builds the brand's fit-scored subreddit pool. Only needs to run once per brand (re-run occasionally to refresh).
  2. Review the pool. reddit_get_pool({ brandId, top }) — the fit-scored subreddit pool, most relevant first. This is the brand-level match: no content needed yet. Each row's posting_style and no_promotion_reason fields are where you read a community's posting norms and promo tolerance — there is no separate "get subreddit rules" tool, it's surfaced here.
  3. Match content. reddit_suggest({ postId }) (an existing BlogArticle id) or reddit_suggest({ title, content, detail: "medium" }) (pasted content) — returns up to 8 best-fit subreddits from the pool, each with 2–3 posting angles (angle type + tailored title + framing hook), match_score, promotion_mode, buyer_intent, reason, and rule_to_watch. Use detail: "medium" to get all angles plus reason/rule_to_watch. Requires the pool from step 1 to exist.
  4. (Optional) Pick a voice. list_voices({}) → get a voiceId, or use "none" for no voice. See the postking-brand-voice skill for details on managing voice profiles.
  5. Rewrite natively. reddit_rewrite({ subreddit, voiceId, sourcePostId, angle, length, variations }) (or sourceContent + optional sourceTitle instead of sourcePostId) — subreddit and angle should come from reddit_suggest's results; voiceId is required. Usually returns the finished post inline; if it returns a postId instead, poll get_post({ postId }) until operationStatus is COMPLETED.
  6. Review saved posts. reddit_list_posts({ brandId }) — cursor-paginated list of past rewrites, each with outputData (redditTitle, body, notes, wordCount, angle, length, subreddit).

Important — Reddit is repurpose-to-review, not scheduled publishing. PostKing does not post to Reddit on the brand's behalf. reddit_rewrite produces a review-ready native draft; the human copies it into Reddit and posts it themselves. Always surface the suggested rule_to_watch and promotion_mode to the user before they post, so they don't get a post removed for breaking a community's rules.

CLI fast path

The reddit_* tools are MCP-only today — there is no pking CLI equivalent.

Expected Output

A fit-scored subreddit pool for the brand, a shortlist of best-fit communities with tailored angles for a given piece of content, and a Reddit-native rewritten draft (with rule/promotion-mode guidance) ready for human review and posting.

Pitfalls

  • Empty pool / "no subreddit pool yet" on reddit_suggest or reddit_rewrite — run reddit_generate_pool and poll get_job to completion first.
  • Subreddit not in pool on reddit_rewrite — pick a subreddit value from reddit_get_pool or a reddit_suggest result rather than typing one in.
  • INSUFFICIENT_CREDITS — surface the checkoutUrl from the error envelope and stop, or hand off to the postking-getting-started skill's billing section (billing_list_packsbilling_topup).
  • RATE_LIMITED — back off using the retryAfter value from the error envelope before retrying.
  • UNAUTHORIZED — re-run the login flow described in the postking-getting-started skill.

Verification

  • reddit_get_pool({ brandId }) should return a non-empty pool after reddit_generate_pool completes.
  • reddit_list_posts({ brandId }) should include the new draft after reddit_rewrite finishes.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.