CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

apibible

API.Bible integration. Manage data, records, and automate workflows. Use when the user wants to interact with API.Bible data.

Quality

65%

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 ./skills/apibible/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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.

The body provides concrete, executable membrane CLI commands organized into a clear install → authenticate → connect → search → run workflow, with explicit connection-state polling and error-state feedback loops. Minor flaws include a dangling "Step 2" reference, an action table with empty description cells, and a few sentences of over-explanation.

DimensionReasoningScore

Conciseness

The body is dominated by tight, executable commands and tables, with only minor over-explanation to trim ("It's used by developers, churches, and organizations...", "This is the fastest way to get a connection", and the rambling "Agent Types" aside). Fits anchor 4: efficient with minor instances that could be trimmed.

4 / 5

Actionability

Concrete copy-paste commands throughout (install, login with headless variant, connection ensure with --wait polling, action list/run with JSON input, proxy with a flags table). Minor gaps: the Popular actions table has an empty Description column, no run example with real parameter values, and ambiguity between action id and Key. Fits anchor 4: mostly executable with minor gaps.

4 / 5

Workflow Clarity

Clear install → authenticate → connect → poll → search → run sequence with genuine feedback loops (--wait long-polling, re-poll after CLIENT_ACTION_REQUIRED, explicit error-state handling). Minor gap: "skip to Step 2" references a Step 2 heading that does not exist. Fits anchor 4: clear sequence with most checkpoints present.

4 / 5

Progressive Disclosure

No bundle files exist, so scored on body structure: well-organized, focused sections with nothing nested or buried. The 14-row Popular actions table with empty description cells could arguably live in a reference file — a minor organization gap. Fits anchor 4: good structure with most content appropriately placed.

4 / 5

Total

16

/

20

Passed

Description

41%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.

The description names the domain and includes an explicit 'Use when' clause, but relies on generic boilerplate ('Manage data, records, and automate workflows') instead of any concrete API.Bible capabilities, and the 'when' clause is circular. Natural domain keywords (bible, scripture, verse, passage) are absent, leaving only the product name as a trigger term.

Suggestions

Replace "Manage data, records, and automate workflows" with concrete domain actions, e.g., "Search Bible translations, fetch verses, chapters, passages, and audio Bibles, and list available Bibles and books via API.Bible."

Add natural trigger terms users would actually say — bible, scripture, verse, passage, Bible translation — rather than relying solely on the product name "API.Bible".

Make the 'Use when' clause non-circular by describing trigger situations (e.g., "Use when the user asks to look up scripture, fetch a verse or passage, or search Bible translations") instead of restating "interact with API.Bible data".

DimensionReasoningScore

Specificity

The domain is named ("API.Bible integration") but the actions are generic boilerplate ("Manage data, records, and automate workflows") with no concrete domain capabilities such as fetching verses, passages, or searching translations. Matches anchor 2: names the domain but actions are minimal or generic.

2 / 5

Completeness

An explicit "Use when the user wants to interact with API.Bible data" clause is present, but the 'what' is vague buzzword boilerplate and the 'when' is circular (restates the domain instead of giving trigger situations). Falls between anchor 3 (clear what, weak when) and anchor 4 (both present), closer to 3 because the 'what' is the weak half.

3 / 5

Trigger Term Quality

The only keyword is the technical product name "API.Bible"; natural phrases a user would say — bible, scripture, verse, passage, translation — are entirely absent. Fits anchor 2 (missing the natural phrases users say) rather than 3, since even the one relevant term is the product name rather than domain language.

2 / 5

Distinctiveness Conflict Risk

"API.Bible" marks a clear niche with minimal wrong-skill trigger risk, but the tail phrase "Manage data, records, and automate workflows" is boilerplate shared across sibling integration skills. Fits anchor 4: mostly distinct with minor overlap risk.

4 / 5

Total

11

/

20

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.

Validation — 15 / 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

membranedev/application-skills

Path

skills/apibible/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.