Agent skill

Tweetsmash API

by pedronauck in pedronauck/skills

Integrate TweetSmash REST bookmark retrieval, filtering, pagination, and label management into scripts or tools.

No licenceAuto-check passedProductivity & Automation

Install Tweetsmash API

skills CLI
$ npx skills add pedronauck/skills --skill tweetsmash-api -a claude-code

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

GitHub CLI
$ gh skill install pedronauck/skills tweetsmash-api --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/pedronauck/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/mine/tweetsmash-api .claude/skills/tweetsmash-api && 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/

Facts

Skill name
tweetsmash-api
GitHub stars
634
Token cost
~1k tokens
SKILL.md length
525 words
Files
6 (incl. scripts, references, assets)
Skills in repo
65
Repo updated
First seen
Licence
None found

At a glance

Integrate TweetSmash REST bookmark retrieval, filtering, pagination, and label management into scripts or tools.

  • Works in 3 steps: Confirm that a TweetSmash API key is… → Read references/api-reference.md to… → If the task requires bookmark filtering…
  • Tasks that involve Copywriting
  • SKILL.md covers Procedures and Error Handling
  • Runs Python scripts from its folder; calls python3; reaches api.tweetsmash.com; needs TWEETSMASH_API_KEY

What it does

Tweetsmash API is an agent skill from pedronauck/skills. Integrate TweetSmash REST bookmark retrieval, filtering, pagination, and label management into scripts or tools. Excludes browser automation, other Twitter/X APIs, and marketing copy.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts, reference files and assets (for example `assets/add-labels-body.json`, `assets/remove-labels-body.json` and `references/api-reference.md`).

It sits in Productivity & Automation, covering Copywriting and Browser automation. It works with X (Twitter). The repository describes itself as: My personal favorite skills.

When your agent uses it

  • Tasks that involve Copywriting
  • Tasks that involve Browser automation

Example prompts

  • “/tweetsmash-api”

Requirements

  • Python 3
  • A credential in TWEETSMASH_API_KEY

Workflow steps

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

  1. Confirm that a TweetSmash API key is available before making requests. Prefer TWEETSMASH_API_KEY in the shell environment.
  2. Read references/api-reference.md to confirm the current endpoint, required headers, rate limits, and status codes.
  3. If the task requires bookmark filtering or pagination, read references/bookmarks-filters.md.

What it can do on your machine

Read from SKILL.md and the folder at commit 0422940. 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

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.tweetsmash.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • TWEETSMASH_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Tweetsmash API loads about 1k tokens when it runs, and up to ~1.9k if it reads all its reference files. Until then it costs about 50 tokens; SKILL.md has 525 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~50
When it runs · the whole SKILL.md, loaded when a task matches
~1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.9k

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); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 525 words (~1,013 tokens).

“Use this skill to work directly with the TweetSmash REST API using current endpoint evidence. Reuse documentation already verified in this task; refresh it when missing, stale, or contradicted by the API. Read references/api-reference.md before choosing an endpoint. Read references/bookmarks-filters.md…”

— opening of SKILL.md by pedronauck
name
tweetsmash-api
metadata.author
Pedro Nauck
metadata.github
https://github.com/pedronauck
metadata.repository
https://github.com/pedronauck/skills

Read the full SKILL.md on GitHub

Files

SKILL.md and 5 other files (scripts, references, assets) in skills/mine/tweetsmash-api of pedronauck/skills.

  • SKILL.md
  • assets/add-labels-body.json
  • assets/remove-labels-body.json
  • references/api-reference.md
  • references/bookmarks-filters.md
  • scripts/build-bookmarks-url.py

Open the folder on GitHubat commit 0422940

Compare with similar skills

Tweetsmash API 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.

Tweetsmash API compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tweetsmash API this skillpedronauck/skills634—~1kAutomated safety check: PassNone
Publish X Articlesugarforever/01coder-agent-skills137—~5kAutomated safety check: PassMIT
X Publishaiskillstore/marketplace430—~1.3kAutomated safety check: PassNone
Browser Automation Edge Casesaden-hive/hive11k—~1.8kAutomated safety check: PassMIT
bb-browser Site Commands for OpenClawepiral/bb-browser6.2k—~1kAutomated safety check: PassMIT
X Post PublisherJimLiu/baoyu-skills26k1 repos~4.4kAutomated safety check: WarnMIT

Similar skills

  • Publish X Article

    sugarforever/01coder-agent-skills

    Publishes a Markdown file or URL to the X Articles editor with formatting kept, turning tables, mermaid diagrams and deep headers that X cannot show into images.

    137 GitHub stars~5k tokensUpdated 3 mo ago
    Writing & ContentAuto-check passed
  • X Publish

    aiskillstore/marketplace

    Publish tweets and threads to X (Twitter) draft using browser automation.

    430 GitHub stars~1.3k tokensUpdated today
    Writing & ContentAuto-check passed
  • Step-by-step procedure for debugging browser automation failures on complex sites such as LinkedIn, Twitter/X, single-page apps and Shadow DOM pages.

    11k GitHub stars~1.8k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Runs structured data commands against sites such as Twitter, Reddit, GitHub, YouTube and Zhihu through OpenClaw's browser, reusing your existing login state.

    6.2k GitHub stars~1k tokensUpdated 4 mo ago
    Productivity & AutomationAuto-check passed
  • X Post Publisher

    JimLiu/baoyu-skills

    Publishes text posts, images, videos, quote posts and long-form X Articles written in Markdown through a real Chrome browser.

    26k GitHub starsUsed in 1 repo~4.4k tokens
    Productivity & AutomationAuto-check: warnings
  • Neo

    4ier/neo

    Browse websites, read web pages, interact with web apps, call website APIs, and automate web tasks.

    756 GitHub stars~1.8k tokensUpdated 5 mo ago
    Productivity & AutomationAuto-check passed

More from pedronauck/skills

All 65 skills in this repo
  • Deep Review

    pedronauck/skills

    Review branch diffs, working trees, or PRs in depth with defect, polish and cross-contract coverage.

    634 GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed
  • Yc Apply

    pedronauck/skills

    Prepare, review, and package Y Combinator application answers and founder-video notes using the live form and verified founder facts.

    634 GitHub stars~1.3k tokensUpdated 25 days ago
    Auto-check passed
  • Guide technical communication for software developers. An agent skill from pedronauck/skills.

    634 GitHub starsUsed in 3 repos~2.3k tokens
    Auto-check passed
  • Tauri V2

    pedronauck/skills

    Tauri v2+ cross-platform app development with Rust backend. An agent skill from pedronauck/skills.

    634 GitHub starsUsed in 2 repos~4.1k tokens
    Auto-check passed
  • Hormozi Ad Factory

    pedronauck/skills

    Generates 150-750+ ad variations using Alex Hormozi's combinatorial Hook x Meat x CTA framework.

    634 GitHub stars~2.1k tokensUpdated 25 days ago
    Auto-check passed
  • Yt Master

    pedronauck/skills

    Plans and improves YouTube ideas, titles, thumbnail concepts, scripts, retention, channel strategy, and metric-based diagnosis.

    634 GitHub stars~736 tokensUpdated 25 days ago
    Auto-check passed

Works with

Questions about Tweetsmash API

What does Tweetsmash API do?

Integrate TweetSmash REST bookmark retrieval, filtering, pagination, and label management into scripts or tools. Tweetsmash API is an agent skill from pedronauck/skills. Integrate TweetSmash REST bookmark retrieval, filtering, pagination, and label management into scripts or tools.

When should I use Tweetsmash API?

Tweetsmash API fits situations like: tasks that involve Copywriting; tasks that involve Browser automation.

How do I install Tweetsmash API in Claude Code?

Run `npx skills add pedronauck/skills --skill tweetsmash-api -a claude-code`. Or copy the skill folder (skills/mine/tweetsmash-api in pedronauck/skills) into .claude/skills/tweetsmash-api in your project. Claude Code loads it when a task matches its description.

How do I install Tweetsmash API in Codex?

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

Can I use Tweetsmash API 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 pedronauck/skills --skill tweetsmash-api -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tweetsmash-api, .gemini/skills/tweetsmash-api, .github/skills/tweetsmash-api and .opencode/skills/tweetsmash-api in your project.

What does Tweetsmash API need to run?

Going by SKILL.md and its folder, Tweetsmash API needs Python for the scripts in its folder, the command-line tools its instructions call (python3) and credentials named TWEETSMASH_API_KEY. Our summary lists: Python 3; A credential in TWEETSMASH_API_KEY.

Does Tweetsmash API access the network?

SKILL.md names 1 domain. In commands or code: api.tweetsmash.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Tweetsmash API 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Tweetsmash API use?

No licence was found for Tweetsmash API or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Tweetsmash API use?

About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 897 tokens, read only when the agent opens those files.

What are the alternatives to Tweetsmash API?

Skills that share tags, products or a category with Tweetsmash API: Publish X Article (sugarforever/01coder-agent-skills, 137 stars), X Publish (aiskillstore/marketplace, 430 stars), Browser Automation Edge Cases (aden-hive/hive, 11k stars) and bb-browser Site Commands for OpenClaw (epiral/bb-browser, 6.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tweetsmash API?

pedronauck (a GitHub user) maintains it in pedronauck/skills, which has 634 GitHub stars. The repository holds 65 skills in this directory. The repository was last updated on September 14, 2026.

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