Reddit — OAuth or login-cookie access

The connector injects exactly one of these credentials:

REDDIT_COOKIES: JSON cookie array captured by the ACE browser extension. It includes reddit_session and grants full account access. Secret — never echo, print, log or return it.
REDDIT_TOKEN: official OAuth bearer token (identity read submit).

The helper automatically prefers official OAuth when present and otherwise uses Cookie. It sends Reddit's required descriptive User-Agent and never forwards cookies outside reddit.com.

Script resolution

Bash calls do not share shell variables. Resolve the helper inside every fenced Bash invocation before using it:

R="${SKILL_DIR:-}/scripts/reddit.py"; [ -f "$R" ] || R=$(find /tmp -maxdepth 8 -path '*/skills/*/reddit/scripts/reddit.py' -print -quit 2>/dev/null)
[ -f "$R" ] || { echo "reddit script not found (SKILL_DIR=$SKILL_DIR)" >&2; exit 1; }
python3 "$R" whoami

If authentication fails, ask the user to reconnect at https://studio.acedata.cloud/console/connectors. Do not loop-retry a blocked or expired session.

Read

R="${SKILL_DIR:-}/scripts/reddit.py"; [ -f "$R" ] || R=$(find /tmp -maxdepth 8 -path '*/skills/*/reddit/scripts/reddit.py' -print -quit 2>/dev/null)
[ -f "$R" ] || { echo "reddit script not found (SKILL_DIR=$SKILL_DIR)" >&2; exit 1; }
python3 "$R" whoami
python3 "$R" submissions --limit 10
python3 "$R" comments --limit 10

comment verifies itself: when Reddit answers in a shape it cannot parse, it looks the comment up via comments before reporting anything. If it still says the write likely failed, re-check with comments yourself before resending.

Find threads and check the rules

search returns each hit's fullname (t3_…), which is what comment --parent takes. subreddit-info returns the subreddit's rules — read them before writing anything there.

R="${SKILL_DIR:-}/scripts/reddit.py"; [ -f "$R" ] || R=$(find /tmp -maxdepth 8 -path '*/skills/*/reddit/scripts/reddit.py' -print -quit 2>/dev/null)
[ -f "$R" ] || { echo "reddit script not found (SKILL_DIR=$SKILL_DIR)" >&2; exit 1; }

python3 "$R" search --query "suno api" --time week --limit 10
python3 "$R" search --query "image generation api" --subreddit SideProject
python3 "$R" subreddit-info --subreddit SideProject

--sort defaults to relevance. Reddit's new sort ignores keyword relevance — it returns recent posts that often do not contain the query terms at all. Use --sort new only to scan a specific subreddit's recent activity, never to find threads by keyword.

Reply to a thread — GATED

--parent accepts a fullname (t3_… post, t1_… comment) or a reddit.com permalink. Show the target thread and the exact reply text, then obtain explicit confirmation. Without a trailing --confirm this is a dry run.

R="${SKILL_DIR:-}/scripts/reddit.py"; [ -f "$R" ] || R=$(find /tmp -maxdepth 8 -path '*/skills/*/reddit/scripts/reddit.py' -print -quit 2>/dev/null)
[ -f "$R" ] || { echo "reddit script not found (SKILL_DIR=$SKILL_DIR)" >&2; exit 1; }

python3 "$R" comment --parent t3_1r9yrtn --body-file reply.md
python3 "$R" comment --parent t3_1r9yrtn --body-file reply.md --confirm

Submit a post — GATED

Posting is public. Always show the subreddit, final title and final body/URL, then obtain explicit confirmation. Without a trailing --confirm, both write commands are dry-runs and make no network request.

R="${SKILL_DIR:-}/scripts/reddit.py"; [ -f "$R" ] || R=$(find /tmp -maxdepth 8 -path '*/skills/*/reddit/scripts/reddit.py' -print -quit 2>/dev/null)
[ -f "$R" ] || { echo "reddit script not found (SKILL_DIR=$SKILL_DIR)" >&2; exit 1; }

# Text post: use a file for long Markdown.
python3 "$R" submit-text --subreddit test --title "My title" --text-file post.md
python3 "$R" submit-text --subreddit test --title "My title" --text-file post.md --confirm

# Link post.
python3 "$R" submit-link --subreddit test --title "My title" --url "https://example.com"
python3 "$R" submit-link --subreddit test --title "My title" --url "https://example.com" --confirm

--confirm is honored only when it is the final argument. A title or body that contains the text --confirm can never trigger a write.

Safety and failure handling

Never print REDDIT_COOKIES, REDDIT_TOKEN, reddit_session or the modhash.
Do not vote, send private messages, evade bans, or cross-post identical content. This skill intentionally exposes none of those operations.
Never post the same reply text to more than one thread. Reddit treats repeated identical comments as spam and actions the account, not the comment. Write each reply against the specific thread it answers.
Follow each subreddit's rules — run subreddit-info first. Account age, karma and flair requirements can reject a post or comment; report the rejection without exposing Reddit's raw authenticated response, which may contain reflected credential material.
Do not retry a write automatically. A timeout may occur after Reddit accepted it, and replaying could create a duplicate.
Respect rate limits and never bulk-submit or bulk-comment. Use r/test only for a deliberate end-to-end validation.
Cookie mode drives Reddit's first-party web JSON endpoints and may drift when Reddit changes its site. Report unexpected HTML or route errors as upstream drift instead of guessing another private endpoint.

Self-promotion — read this before marketing anything

Reddit bans accounts for promotion patterns, not for individual links. When the user's goal is promoting their own product:

Answer the question first. A reply must stand on its own as useful even if the product link were removed. If it does not, do not send it.
Disclose the affiliation ("I build X") — undisclosed promotion is the fastest route to a ban.
One link at most, at the end, and never in a post title.
Do not blanket-reply. A handful of genuinely relevant threads beats volume, and volume is exactly what spam detection keys on.
If a subreddit has a dedicated self-promo / "Showoff" thread, use it — that is the sanctioned channel.
A low-karma or new account will have posts auto-removed by AutoModerator in most active subreddits. Check whoami karma and warn the user rather than burning the account on a post that will be silently filtered.

Record the output

After you successfully publish a post or a comment and obtain the live result URL, call the built-in publish_artifact tool ONCE so the user can track this deliverable in My Outputs:

publish_artifact(kind="message", channel="reddit", title="<title>", url="<the REAL returned URL>", status="delivered")

Use the real returned URL — never fabricate one. Call it once per published item, only after delivery is confirmed; skip it (or use status="failed") if publishing failed. See _shared/artifacts.md.