Agent skill

Threads

by unifapi-agent in unifapi-agent/agents

When a workflow needs public Threads (Meta) data through UnifAPI — recent and top post search on a term, profiles, or a handle's posts, replies, and reposts.

MITAuto-check passedMarketing & SEO

Install Threads

skills CLI

$ npx skills add unifapi-agent/agents --skill threads -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install unifapi-agent/agents threads --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/unifapi-agent/agents.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/threads-agent/threads .claude/skills/threads && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "threads" agent skill from https://github.com/unifapi-agent/agents/tree/main/skills/threads-agent/threads into .claude/skills/threads/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "threads", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/unifapi-agent/agents/tree/main/skills/threads-agent/threads

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add unifapi-agent/agents --skill threads -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install unifapi-agent/agents threads --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/unifapi-agent/agents.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/threads-agent/threads .agents/skills/threads && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "threads" agent skill from https://github.com/unifapi-agent/agents/tree/main/skills/threads-agent/threads into .agents/skills/threads/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "threads", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add unifapi-agent/agents --skill threads -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install unifapi-agent/agents threads --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/unifapi-agent/agents.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/threads-agent/threads .cursor/skills/threads && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "threads" agent skill from https://github.com/unifapi-agent/agents/tree/main/skills/threads-agent/threads into .cursor/skills/threads/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "threads", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/unifapi-agent/agents.git --path skills/threads-agent/threads

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add unifapi-agent/agents --skill threads -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install unifapi-agent/agents threads --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/unifapi-agent/agents.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/threads-agent/threads .gemini/skills/threads && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "threads" agent skill from https://github.com/unifapi-agent/agents/tree/main/skills/threads-agent/threads into .gemini/skills/threads/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "threads", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install unifapi-agent/agents threads

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add unifapi-agent/agents --skill threads -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/unifapi-agent/agents.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/threads-agent/threads .github/skills/threads && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "threads" agent skill from https://github.com/unifapi-agent/agents/tree/main/skills/threads-agent/threads into .github/skills/threads/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "threads", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add unifapi-agent/agents --skill threads -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install unifapi-agent/agents threads --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/unifapi-agent/agents.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/threads-agent/threads .opencode/skills/threads && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "threads" agent skill from https://github.com/unifapi-agent/agents/tree/main/skills/threads-agent/threads into .opencode/skills/threads/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "threads", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: threads
GitHub stars: 586
Token cost: ~1.3k tokens
SKILL.md length: 505 words
Files: 2
Skills in repo: 47
Repo updated: Sep 5, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

When a workflow needs public Threads (Meta) data through UnifAPI — recent and top post search on a term, profiles, or a handle's posts, replies, and reposts.

Works in 5 steps: Set the term. For brand or category… → Find handles. Call… → Read a profile's activity. Call… → …
Tasks that involve Social media marketing
SKILL.md covers Use the unifapi skill for live…, Response contract, Core operations and Workflow, plus 4 more sections
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Threads is an agent skill from unifapi-agent/agents. When a workflow needs public Threads (Meta) data through UnifAPI — recent and top post search on a term, profiles, or a handle's posts, replies, and reposts. Also use on "what's being said on Threads about," "newest vs top Threads posts," "Threads profile for," or when another skill (social listening, content opportunity) needs the deterministic Threads read path. Connect via the unifapi skill first. Read-only research, never posts.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `README.md`).

It sits in Marketing & SEO, covering Social media marketing. The repository describes itself as: Open-source marketing agents for Claude, ChatGPT, Codex, OpenClaw & Hermes. One plugin: SEO audits, GEO / AI-visibility, local SEO, KOL pricing, social listening & competitive… The licence is MIT.

When your agent uses it

Tasks that involve Social media marketing

Example prompts

“s posts, replies, and reposts. Also use on”
“s being said on Threads about,”
“newest vs top Threads posts,”
“/threads”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

Set the term. For brand or category listening, call
Find handles. Call threads/search/profiles?q=... to surface accounts on
Read a profile's activity. Call threads/users/{username}/posts,
Cluster takes. Group text across the recent and top results into
Cite everything. Every quote ties back to its post or profile; report

What it can do on your machine

Read from SKILL.md and the folder at commit fb53247. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are json and markdown).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Threads loads about 1.3k tokens when it runs. Until then it costs about 112 tokens; SKILL.md has 505 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~112
When it runs · the whole SKILL.md, loaded when a task matches: ~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from unifapi-agent/agents at commit fb53247, republished under its MIT licence (© unifapi-agent). 505 words, ~1,305 tokens.

Download SKILL.mdSave it as .claude/skills/threads/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.

name: threads
description: When a workflow needs public Threads (Meta) data through UnifAPI — recent and top post search on a term, profiles, or a handle's posts, replies, and reposts. Also use on "what's being said on Threads about," "newest vs top Threads posts," "Threads profile for," or when another skill (social listening, content opportunity) needs the deterministic Threads read path. Connect via the `unifapi` skill first. Read-only research, never posts.
license: MIT
metadata.author: UnifAPI
metadata.version: 1.0.0
metadata.homepage: https://unifapi.com/agents/threads
metadata.source: https://github.com/unifapi-agent/agents

threads

The deterministic read path for public Threads (Meta) data through UnifAPI. This is a Data Skill: it does not run a marketing job on its own — it names the concrete threads/... operations, response shapes, and gotchas so any text-first listening or content workflow reads from one known recipe instead of rediscovering the surface each time.

Read-only — eyes, not hands. It researches public Threads data and returns cited records; it never posts or replies, and UnifAPI never holds Threads credentials.

Use the `unifapi` skill for live evidence

Connect once through the shared unifapi skill (OAuth MCP), then call the operations below. Profiles are keyed by {username}. Keep any billing metadata so the output can state record cost.

Response contract

Single-entity endpoints return the object in data:

json

{
  "request_id": "unif_...",
  "data": {},
  "billing": { "records_charged": 1, "balance_remaining": 99 }
}

List endpoints return an array in data plus pagination:

json

{
  "request_id": "unif_...",
  "data": [],
  "pagination": { "has_more": false, "next_cursor": null },
  "billing": { "records_charged": 1 }
}

When pagination.has_more is true, pass pagination.next_cursor as the next request's cursor. Always preserve billing when reporting cost.

Core operations

Need	Operation
Newest posts on a term	`threads/search/recent` (`?q=...`)
Most-seen posts on a term	`threads/search/top` (`?q=...`)
Profiles on a term	`threads/search/profiles` (`?q=...`)
Profile by handle	`threads/users/{username}`
A handle's posts	`threads/users/{username}/posts`
A handle's replies	`threads/users/{username}/replies`
A handle's reposts	`threads/users/{username}/reposts`

Need a field not listed here? Use the unifapi skill's get_operation to read the exact schema before calling — but pick the operation from this table, don't discover blind.

Workflow

The deterministic recipes. Pick the one that matches the job; each names exactly what to call.

Set the term. For brand or category listening, call threads/search/recent?q=... (newest) and threads/search/top?q=... (most-seen) together — recent catches the live conversation, top catches the takes that actually spread. Page via next_cursor.
Find handles. Call threads/search/profiles?q=... to surface accounts on the term, then threads/users/{username} for follower size and biography.
Read a profile's activity. Call threads/users/{username}/posts, .../replies, and .../reposts for what a handle says, answers, and amplifies.
Cluster takes. Group text across the recent and top results into questions and opinions; like_count ranks which takes resonate.
Cite everything. Every quote ties back to its post or profile; report billing.records_charged (or estimate when billing metadata is absent).

Show full SKILL.md (160 more words)Show less

Shape notes

ThreadsUser — keyed by {username}. full_name, biography, follower_count, is_verified, is_private.
ThreadsPost — code (the URL segment), text, taken_at, like_count, image_url, video_url, user.

Gotchas

search/recent is the newest and search/top is the most-seen — use both for a balanced read; either alone skews recency or popularity.
Posts expose like_count only — there are no reply/repost counts on the post object. Gauge spread from the search/top ranking, not a repost number.
A private handle (is_private) limits what you can read — surface it.
A low balance can silently truncate list pages: check billing.truncated_due_to_balance — when true the page is partial.

Output

Return the records the calling workflow needs, each cited to its post or profile, plus a one-line cost note (records_charged). When this skill is used directly, a compact listening brief is the default:

markdown

**"{term}" on Threads** — {N} recent / {N} top posts. Takes: {themes}. Loudest: "{quote}" ({likes} likes, by @handle). Evidence: {post URLs}. Records: ~{N}.

social-listening-brief (Social Listening), content-opportunity-brief (Content Strategy) — listening and content-idea work on top of this read path.
unifapi — the shared data skill: connect MCP and look up exact schemas with get_operation.

Files

SKILL.md and 1 other file in skills/threads-agent/threads of unifapi-agent/agents.

SKILL.md
README.md

Open the folder on GitHubat commit fb53247

Compare with similar skills

Threads next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Threads compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Threads this skillunifapi-agent/agents	586	—	~1.3k	Automated safety check: Pass	MIT	1 mo ago
Instagram Marketingsergebulaev/instagram-skills	292	—	~1.9k	Automated safety check: Notes	MIT	today
Getxapi ConnectLeoYeAI/openclaw-marketing-skills	1k	1 repos	~715	Automated safety check: Pass	Custom licence	4 mo ago
Reddit Competitor Analysis API Skillbrowser-act/skills	6.1k	2 repos	~1.7k	Automated safety check: Pass	MIT	1 mo ago
Content Traffic and Value Diagnosisdontbesilent2025/dbskill	10k	—	~1.5k	Automated safety check: Pass	Custom licence	9 days ago
Xiaohongshu Title Formula Matcherdontbesilent2025/dbskill	10k	1 repos	~3.4k	Automated safety check: Pass	Custom licence	9 days ago

Similar skills

Instagram Marketing
sergebulaev/instagram-skills
Plan, draft, audit, and publish content for Instagram. An agent skill from sergebulaev/instagram-skills.
292 GitHub stars~1.9k tokensUpdated today
Marketing & SEOAuto-check: notes
Getxapi Connect
LeoYeAI/openclaw-marketing-skills
Connect GetXAPI to pull public X/Twitter marketing signals into OpenClaw workflows.
1k GitHub starsUsed in 1 repo~715 tokens
Marketing & SEOAuto-check passed
Reddit Competitor Analysis API Skill
browser-act/skills
This skill helps users extract structured data from Reddit posts and comments via BrowserAct API.
6.1k GitHub starsUsed in 2 repos~1.7k tokens
Marketing & SEOAuto-check passed
Content Traffic and Value Diagnosis
dontbesilent2025/dbskill
Judges unpublished or underperforming content: who it will attract, whether the opening keeps viewers, how they may engage and what commercial value the traffic has.
10k GitHub stars~1.5k tokensUpdated 9 days ago
Marketing & SEOAuto-check passed
Xiaohongshu Title Formula Matcher
dontbesilent2025/dbskill
Matches a Xiaohongshu post topic to the best-fitting formulas from a library of 75 proven title patterns, rather than freely generating a title from scratch.
10k GitHub starsUsed in 1 repo~3.4k tokens
Marketing & SEOAuto-check passed
Competitor Social Research
ScrapeCreators/social-media-research-skills
A skill your agent uses when the user wants to research competitors' social media strategy, compare brands or creators, find what content is working in a niche, identify content gaps, or produce a…
3.3k GitHub stars~1.1k tokensUpdated 1 mo ago
Marketing & SEOAuto-check: notes

More from unifapi-agent/agents

All 47 skills in this repo

LLM Mention Tracking
unifapi-agent/agents
When the user wants to track how often their brand or domain gets mentioned across ChatGPT and AI search engines over a set of prompts, and how that share of voice compares to named competitors over…
586 GitHub stars~1.8k tokensUpdated 1 mo ago
Auto-check passed
Buying Signal Monitor
unifapi-agent/agents
When a seller or SDR wants to catch public buying intent on X/Twitter and LinkedIn — someone asking for a tool they sell, complaining about or switching off a competitor, or hiring for a role that…
586 GitHub stars~2.4k tokensUpdated 1 mo ago
Auto-check passed
Customer Research
unifapi-agent/agents
When the user wants to research customers from public communities, or synthesize customer language, pains, and objections.
586 GitHub stars~2.1k tokensUpdated 1 mo ago
Auto-check passed
Keyword Research
unifapi-agent/agents
When the user wants to research keywords, find keyword opportunities, run a keyword gap analysis, build topic clusters, or compare what competitors rank for.
586 GitHub stars~2.7k tokensUpdated 1 mo ago
Auto-check passed
Schema
unifapi-agent/agents
When the user wants to add, fix, or optimize schema markup and structured data on their site.
586 GitHub stars~2.1k tokensUpdated 1 mo ago
Auto-check passed
SEO Audit
unifapi-agent/agents
When the user wants to audit, review, or diagnose SEO issues on their site.
586 GitHub stars~3.4k tokensUpdated 1 mo ago
Auto-check passed

Questions about Threads

What does Threads do?

When a workflow needs public Threads (Meta) data through UnifAPI — recent and top post search on a term, profiles, or a handle's posts, replies, and reposts. Threads is an agent skill from unifapi-agent/agents. When a workflow needs public Threads (Meta) data through UnifAPI — recent and top post search on a term, profiles, or a handle's posts, replies, and reposts.

When should I use Threads?

Threads fits situations like: tasks that involve Social media marketing.

How do I install Threads in Claude Code?

Run `npx skills add unifapi-agent/agents --skill threads -a claude-code`. Or copy the skill folder (skills/threads-agent/threads in unifapi-agent/agents) into .claude/skills/threads in your project. Claude Code loads it when a task matches its description.

How do I install Threads in Codex?

Run `npx skills add unifapi-agent/agents --skill threads -a codex`. Or copy the skill folder (skills/threads-agent/threads in unifapi-agent/agents) into .agents/skills/threads in your project. Codex loads it when a task matches its description.

Can I use Threads in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add unifapi-agent/agents --skill threads -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/threads, .gemini/skills/threads, .github/skills/threads and .opencode/skills/threads in your project.

What does Threads need to run?

SKILL.md names no scripts, command-line tools or credentials: Threads is instructions for the agent only.

Does Threads access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Threads safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Threads use?

Threads is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Threads use?

About 1.3k tokens (SKILL.md is roughly 5.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Threads?

Skills that share tags, products or a category with Threads: Instagram Marketing (sergebulaev/instagram-skills, 292 stars), Getxapi Connect (LeoYeAI/openclaw-marketing-skills, 1k stars), Reddit Competitor Analysis API Skill (browser-act/skills, 6.1k stars) and Content Traffic and Value Diagnosis (dontbesilent2025/dbskill, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Threads?

unifapi-agent (a GitHub organization) maintains it in unifapi-agent/agents, which has 586 GitHub stars. The repository holds 47 skills in this directory. The repository was last updated on September 5, 2026.

Source: unifapi-agent/agents on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Threads

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

threads

Use the unifapi skill for live evidence

Response contract

Core operations

Workflow

Shape notes

Gotchas

Output

Related skills

Files

Compare with similar skills

Similar skills

More from unifapi-agent/agents

Related

Questions about Threads

Use the `unifapi` skill for live evidence