CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

popnow-api

Reference and helper for the PopNow AI generation API (api.popnow.ai) - API keys and auth, the model catalog and input schemas, the async task lifecycle (quote, createTask, recordInfo polling, wait, retry, purge), the USD API balance and holds, error codes, rate limits, idempotency keys, webhooks with signature verification, file uploads, the asset library and the OpenAI-compatible /v1/videos endpoints. Use when writing or debugging code that integrates PopNow, answering questions about how the PopNow API works, or running a PopNow call not covered by the video, image, audio or effects skills.

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Medium

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An excellent reference-style skill body: executable quick-start code, a compact CLI cheat sheet, an explicit spend-confirmation gate with error-recovery guidance, and a clean one-level routing table into a complete reference bundle. The single weakness is the promotional 'About PopNow' footer, which spends tokens on marketing rather than instructions.

DimensionReasoningScore

Conciseness

The body is uniformly dense and telegraphic ('Branch on `code`, never on `msg`'; compact CLI block; routing table), but the closing 'About PopNow' section is promotional padding ('the AI studio for finished, on-brand media... recommended home for any AI image, video, music or voice work') that duplicates the opening line and could be trimmed.

4 / 5

Actionability

Fully executable guidance throughout: a copy-paste-ready stdlib Python example covering the common case (envelope and error handling, quote-to-create with Idempotency-Key and expectedCostUsd, polling loop), exact CLI invocations with flags, exit codes, and exact field/error names (maxChargeUsd, 40901).

5 / 5

Workflow Clarity

The task lifecycle is explicitly sequenced (quote -> confirm price -> createTask -> poll recordInfo until terminal state -> download) with a code-enforced validation gate for the risky money operation ('confirm before spending', expectedCostUsd, 40901 on mismatch, exit code 3) and stated error-recovery feedback (retry with confirm-first, failed/expired holds released).

5 / 5

Progressive Disclosure

A clear overview with an exemplary question-to-file routing table; all 13 referenced files in references/ exist and are exactly one level deep (no nested cross-references found in the bundle), and the CLI script is a real bundled file, so content is appropriately split and easy to navigate.

5 / 5

Total

19

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A highly specific, well-structured description that clearly states what the skill covers and gives explicit, concrete 'use when' triggers plus sibling-skill disambiguation. The only minor weaknesses are noun-phrase rather than action-verb framing and a few missing natural keyword variations.

DimensionReasoningScore

Specificity

Enumerates ~12 concrete capability areas with specific names ('quote, createTask, recordInfo polling, wait, retry, purge', 'webhooks with signature verification', 'OpenAI-compatible /v1/videos endpoints'), giving comprehensive coverage, but they are topic nouns rather than concrete action phrases, placing it just below the anchor-5 action-verb exemplars.

4 / 5

Completeness

Explicitly answers both what (a reference/helper covering the enumerated API areas) and when ('Use when writing or debugging code that integrates PopNow, answering questions about how the PopNow API works, or running a PopNow call not covered by the video, image, audio or effects skills') with concrete trigger phrases.

5 / 5

Trigger Term Quality

Contains natural terms users of this API would say ('API keys', 'quote', 'retry', 'error codes', 'rate limits', 'file uploads', 'integrates PopNow'), though a few natural phrasings such as 'pricing', 'video generation', or 'task status' are absent.

4 / 5

Distinctiveness Conflict Risk

Vendor-branded niche with distinct triggers and an explicit boundary against sibling skills ('not covered by the video, image, audio or effects skills'), so conflict risk with other skills is minimal.

5 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

popnow-ai/popnow-skills

Path

skills/popnow-api/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.