CtrlK
BlogDocsLog inGet started
Tessl Logo

muapi-instagram-post

Create a polished, on-brand Instagram post — square or portrait hero image with matching caption and hashtags.

60

Quality

70%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.opencode/skills/muapi-instagram-post/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

72%

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

The body is well-organized and concise with a clear two-phase sequence, but the CLI command guidance is incomplete and the workflow lacks explicit validation/error-handling checkpoints.

Suggestions

Show a complete, copy-paste-ready `muapi image generate` invocation including how the prompt and aspect_ratio arguments are passed, so actionability reaches 3.

Add an explicit validation step after image generation (e.g., confirm the output file exists / poll status) before composing the caption, to add a workflow checkpoint.

Remove the bolded restatement of the description under the title to tighten conciseness further.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — it does not explain basic concepts — and each section (Inputs, two phases, Notes) earns its place, matching the 'lean and efficient' anchor despite a minor redundant bolded description line.

3 / 3

Actionability

`muapi image generate` with model=nano-banana-2 and aspect_ratio is concrete, but the full call syntax (how the prompt argument is passed, output handling) is not shown, matching 'some concrete guidance but incomplete' rather than copy-paste-ready level 3.

2 / 3

Workflow Clarity

Phase A then Phase B is a clear sequence, but there are no explicit validation checkpoints or error-recovery steps (e.g., handling a failed image generation), matching 'steps listed but validation gaps' rather than the checkpointed level 3.

2 / 3

Progressive Disclosure

No bundle files exist and the skill is self-contained with well-organized sections (Inputs, Steps, Notes, Trigger Keywords), which the rubric's simple-skills note allows to score 3 without external references.

3 / 3

Total

10

/

12

Passed

Description

67%

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

The description is specific and clearly distinct, but lacks explicit 'when to use' trigger guidance and only includes one natural keyword, limiting trigger-term coverage and completeness.

Suggestions

Add an explicit 'Use when…' clause (e.g., 'Use when creating an Instagram post, feed image, or Reels cover') to raise completeness to 3.

Include natural keyword variations such as 'IG post', 'feed post', and 'Reels' alongside 'Instagram post' to broaden trigger-term coverage.

Keep the existing concrete deliverable list — it is already strong on specificity and distinctiveness.

DimensionReasoningScore

Specificity

"square or portrait hero image with matching caption and hashtags" lists multiple concrete deliverables (image with format variants, caption, hashtags), matching the 'lists multiple specific concrete actions' anchor rather than the partial coverage of level 2.

3 / 3

Completeness

It clearly states what the skill does but has no 'Use when…' clause or equivalent explicit trigger guidance, which the guidelines cap at 2 — it is not level 1 because the 'what' is fully articulated.

2 / 3

Trigger Term Quality

Only "Instagram post" appears as a natural term; common variations users say ("IG post", "feed post", "Reels") are absent, so it matches 'some relevant keywords but missing common variations' rather than the full coverage of level 3.

2 / 3

Distinctiveness Conflict Risk

The Instagram-post niche with image-plus-caption-plus-hashtags is specific and unlikely to trigger for unrelated skills, matching the 'clear niche with distinct triggers' anchor.

3 / 3

Total

10

/

12

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
SamurAIGPT/Generative-Media-Skills
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.