SkillAgentSearch skills...

vidseeds-efficiency

Use before expensive VidSeeds MCP workflows - seeds, daily MCP call quotas, async jobId polling, when to call vidseeds_get_seed_balance, and avoiding retry loops on MCP_QUOTA_EXCEEDED or insufficient seeds.

Install / Use

npx skills add hashgraph-online/awesome-codex-plugins --skill vidseeds-efficiency

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

81/100

Category

Automation

Supported Platforms

Universal

Our assessment of vidseeds-efficiency

vidseeds-efficiency scores 81/100 on our quality scale, 2407th of 2,790 Automation skills we index.

Its SKILL.md is 5.3 KB long, well organised into 8 sections and no code examples: a solid amount of guidance for an agent.

With 1,075 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
26/30
Structure
13/20
Description
15/15
Adoption
13/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so vidseeds-efficiency is actively maintained.
  • Our last check on 2026-11-08 found the source still online.
  • It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-03. Automated pattern scan on 2026-10-03. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

vidseeds-efficiency compared with similar skills

All 4 of these similar skills score higher than vidseeds-efficiency; compare them before choosing.

SkillScoreStarsUpdatedFormat
vidseeds-efficiency (this skill)by hashgraph-online811.1k53d agoSKILL.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md
CowAgentby zhayujie10048.0ktodayCLAUDE.md

Frequently asked questions

How do I install vidseeds-efficiency?
Run npx skills add hashgraph-online/awesome-codex-plugins --skill vidseeds-efficiency. The install tabs above show the steps for each supported agent.
Which AI agents does vidseeds-efficiency work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is vidseeds-efficiency safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is vidseeds-efficiency still maintained?
The repository was last updated about 2 months ago, so vidseeds-efficiency is actively maintained.

name: vidseeds-efficiency description: Use before expensive VidSeeds MCP workflows - seeds, daily MCP call quotas, async jobId polling, when to call vidseeds_get_seed_balance, and avoiding retry loops on MCP_QUOTA_EXCEEDED or insufficient seeds. license: MIT

VidSeeds MCP efficiency

Read this before multi-step or charge-bearing workflows.

Orient first (free)

New to this server, or unsure which tool does the job? Call vidseeds_guide - it returns the capability map, the recommended tool chain for a stated goal, and what VidSeeds does not do. It is free and quota-exempt, so it never costs seeds or a call-bucket token. The server's initialize instructions and the vidseeds://guide resource carry the same orientation; workflow prompts (e.g. optimize-youtube-video, make-thumbnail) hand you the ready-made tool chain. Reach for these before concluding a capability is missing. Parameter-level field docs are intentionally omitted from tools/list JSON schemas to save context - use vidseeds_guide (with a goal) or read vidseeds://guide when you need argument semantics beyond types/enums.

Two cost layers

  1. Per-tool seeds - Some tools spend seeds (thumbnails, intelligence, translation, etc.). Read-only tools are free. Charge-bearing tools state their seed cost in the first sentence of their compressed tools/list description; when it is not there, call vidseeds_guide with the tool name for the confirmed cost. Confirm with the user before charge-bearing calls. (2026-06: use fields: ["description","tags"] on regenerate for light/correct-price partials; thumbnail edits cost more than generation when using input reference image.)
  2. Daily MCP call quota - Almost every tool call counts toward a plan bucket (continuous refill, not midnight reset). When the bucket is empty, each extra call costs 1 seed on top of any per-tool cost.

| Plan | Refill / day | Bucket cap | | ------- | ------------ | ---------- | | Sprout | 1,000 | 2,000 | | Growth | 3,000 | 6,000 | | Harvest | 8,000 | 16,000 | | Agency | 20,000 | 40,000 | | Trial | 1,000 | 1,000 |

Free and quota-exempt: vidseeds_get_seed_balance, vidseeds_get_seed_balance_and_subscription, vidseeds_guide.

Before expensive work

  1. vidseeds_get_seed_balance - seeds, remaining included MCP calls, overage rate (free).
  2. Tell the user expected per-tool seed cost (from the tool's compressed description, or vidseeds_guide when the description omits it).
  3. Prefer async + poll for long jobs instead of hammering sync tools that may time out at the edge.

Promo campaign note: vidseeds_generate_promo_campaign_pack is seed-charged on successful AI generation; conversion to drafts with vidseeds_create_social_posts_from_campaign_pack is not the billable AI step.

Async job pattern

Many writes return immediately with jobId (and often pollTool or a named poll tool in the response):

  1. Call the async or generate tool → capture jobId and expectedCostSeeds if present.
  2. Poll the indicated tool every ~3s until completed or failed.
  3. On failed, surface the error once; do not retry in a tight loop.

Examples:

| Start | Poll | | -------------------------------------------- | ---------------------------------------------- | | vidseeds_generate_thumbnail | vidseeds_get_thumbnail_job | | vidseeds_regenerate_project_metadata_async | vidseeds_get_regenerate_project_metadata_job | | vidseeds_create_project_metadata_async | vidseeds_get_create_project_metadata_job | | vidseeds_optimize_marketing_metadata_async | vidseeds_get_optimize_marketing_metadata_job |

Thumbnail generation is typically 70–100s. Project metadata regeneration can be 60–130s - prefer async variants for production.

Errors - do not spin

| Code / message | Action | | ----------------------------- | ------------------------------------------------------------------------------- | | AUTH_REQUIRED / 401 | PAT missing - see vidseeds-setup | | SUBSCRIPTION_REQUIRED / 402 | Trial ended - user must subscribe | | MCP_QUOTA_EXCEEDED | Stop retrying; show top-up link from error; wait for bucket refill or add seeds | | Insufficient seeds | vidseeds_get_seed_balance; user tops up at https://vidseeds.ai/seeds |

Minimize round-trips

  • Use vidseeds_get_project_snapshot when you need project + platform rows in one call instead of many get_project loops.
  • For connections, vidseeds_list_platform_connections before per-id fetches unless you already have connectionId.
  • Batch discovery: vidseeds_get_bulk_video_metadata when comparing many videos.
  • Reuse the same requestId / idempotency keys on retries the tool docs allow - avoids double billing.

When tools/list is enough

tools/list descriptions are compressed (first sentence + safety signals: seed cost, destructive warnings, async polling); parameter shapes and full argument semantics live in vidseeds_guide / vidseeds://guide. Skills teach composition; do not duplicate the full catalog here.

Related Skills

View on GitHub
GitHub Stars1.1k
CategoryAutomation
Updated1mo ago
Forks294

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions