CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

citadel-id

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

Quality

69%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/citadel-id/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 is a largely executable, well-sequenced CLI guide with genuine polling/error feedback loops — a solid integration skill. Its main weaknesses are localized padding (product pitch, broken Overview section, filler lines) and one empty "Popular actions" section that repeats earlier content instead of listing real actions.

Suggestions

Delete the broken Overview bullet list (Person listed twice, dangling "Identifier") and the filler line "Use action names and parameters as needed"; replace with a one-line entity summary (persons, cases, relationships, watchlists) if needed.

Either populate "Popular actions" with 3-5 real action examples (id + one-line purpose) or merge that section into "Searching for actions" to remove the duplication.

Fix the step labeling: number the sections consistently ("Step 1: connect", "Step 2: search & run actions") so the existing "skip to Step 2" and "#### 1b" references resolve, and add one line of recovery guidance for CONFIGURATION_ERROR/SETUP_FAILED beyond "check the error field".

DimensionReasoningScore

Conciseness

The bulk is efficient command reference, but there is removable padding: the three-sentence product pitch ("It helps organizations securely manage user authentication and authorization for their applications and resources"), the malformed Overview bullet list (Person appears twice, "Identifier" dangles with no meaning), and the filler line "Use action names and parameters as needed.". This is more than "minor instances of over-explanation" (anchor 4) but well short of heavily padded (anchor 2).

3 / 5

Actionability

Concrete executable commands throughout — install, login with headless completion, `connection ensure`, state polling with `--wait`, `action list`/`run` with `--input` JSON, and a proxy flags table. Fits "Mostly executable guidance… with minor gaps": the "Popular actions" heading promises examples but only restates the search command, and no worked run example with a real action id is shown — keeping it below anchor 5.

4 / 5

Workflow Clarity

A clear sequence (install → login → connection → poll state → handle clientAction → search actions → run → proxy fallback) with real feedback loops: poll until state leaves BUILDING, re-poll after the user completes an action, and explicit error-state handling. Minor gaps keep it below 5: "skip to Step 2" references steps that are never numbered or labeled, and CONFIGURATION_ERROR recovery stops at "check the error field".

4 / 5

Progressive Disclosure

A single-file skill with no bundle files (no references/, scripts/, or assets/ exist) and well-organized sections covering install, auth, connection, actions, and proxy — nothing is buried and the official-docs link is clearly signaled. Fits "Good structure; most content appropriately placed; minor organization gaps": the redundant "Popular actions" section (a repeat of "Searching for actions") and the dangling "1b" step numbering are the main gaps keeping it below 5.

4 / 5

Total

15

/

20

Passed

Description

57%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 has the right structure (what + explicit Use-when) and a distinctive product-name trigger, but the capability statement is generic marketing boilerplate. Replacing "Manage data, records, and automate workflows" with the actual integration capabilities would lift specificity and trigger coverage substantially.

Suggestions

Replace the generic "Manage data, records, and automate workflows" with concrete operations, e.g. "Search and manage persons, cases, relationships, and watchlists; run verification actions against the Citadel ID API".

Broaden the trigger clause to cover natural phrasings beyond the product name, e.g. "Use when the user mentions Citadel ID, identity verification, watchlist screening, or wants to query/manipulate persons or cases".

Name what the integration actually involves (Membrane CLI actions + direct API proxy fallback) so the description previews the mechanism described in the body.

DimensionReasoningScore

Specificity

"Manage data, records, and automate workflows" names the Citadel ID domain but the actions are generic boilerplate — none of the concrete entities from the body (persons, cases, relationships, watchlists) or operations appear. This matches the anchor "Names the domain but actions are minimal or generic"; it is above 1 because the domain is clearly named, and below 3 because no verb+object pair is genuinely concrete.

2 / 5

Completeness

Both parts are explicitly present: what ("Citadel ID integration. Manage data, records, and automate workflows") and when ("Use when the user wants to interact with Citadel ID data"). Fits "Has both 'what' and 'when'; 'when' could be more explicit or specific"; not 5 because the what is generic and the when is narrow, not 3 because the Use-when clause is explicit rather than implied.

4 / 5

Trigger Term Quality

"Citadel ID" is a strong natural trigger users would actually say, but beyond it only generic terms ("data", "records") appear — no synonyms or domain vocabulary like identity verification, cases, or watchlist. This matches "Some relevant keywords but missing common variations or synonyms"; not 4 because keyword coverage collapses to just the product name.

3 / 5

Distinctiveness Conflict Risk

The distinct product name gives a clear niche with minimal conflict risk when mentioned, but the generic tail ("manage data… automate workflows") overlaps with any data/integration skill if the product name is not said. Fits "Mostly distinct; minor overlap risk"; not 5 due to that generic overlap.

4 / 5

Total

13

/

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/citadel-id/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.