CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

chatfuel

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

Quality

75%

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/chatfuel/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 is a strong, command-driven integration guide: every phase has executable examples, and the connection lifecycle includes explicit state-based checkpoints and recovery paths. The main weaknesses are padded background/explanatory prose and internal reference incoherence ('Step 2' and '1b' point to steps that are never labeled), plus an entity hierarchy that is listed but never tied to any action.

Suggestions

Cut the background padding: remove the 'Chatfuel is a platform...' business-use paragraph, the filler line 'Use action names and parameters as needed.', and editorial asides like 'This will burn less tokens and make communication more secure' — keep only non-obvious operational facts.

Fix internal step references: label the sections as Steps 1, 1b, 2, 3 (or drop the 'skip to Step 2' phrasing) so navigation instructions resolve to real anchors.

Either explain how the Chatfuel entity hierarchy (Account/Chatbot/Block/Group/User) maps to the actions in the table, or delete the hierarchy section — as written it adds tokens without actionable guidance.

DimensionReasoningScore

Conciseness

The body is mostly efficient command/example pairs, but it includes padding: the opening explains what Chatfuel is and who uses it ('It's primarily used by businesses and marketers to automate customer service, marketing campaigns, and lead generation through conversational interfaces'), filler lines like 'Use action names and parameters as needed.', and editorial commentary such as 'so you can focus on the integration logic rather than auth plumbing' and 'This will burn less tokens'. This fits anchor 3 (mostly efficient with some unnecessary explanation) rather than 4, where such instances would be minor.

3 / 5

Actionability

Guidance is fully executable throughout: install command, login including the headless 'login complete <code>' path, 'connection ensure', polling with '--wait', action search/run commands with a '--input' JSON example, a popular-actions table, and a proxy command with a complete flags table. This matches anchor 5 (copy-paste ready commands covering common cases) rather than 4, which would allow minor gaps.

5 / 5

Workflow Clarity

The sequence (install CLI, authenticate, ensure connection, poll state, search actions, run actions, proxy fallback) is clear, and the connection state machine (READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR / SETUP_FAILED) provides explicit checkpoints with recovery guidance. However, the text says 'skip to **Step 2**' and uses a '1b' subsection header while no steps are actually numbered, leaving dangling references — a minor coherence gap that keeps this at anchor 4 rather than 5.

4 / 5

Progressive Disclosure

This is a single-file skill (no references/scripts/assets bundle exists) of about 150 lines with well-organized sections covering setup, connection, actions, proxy, and best practices. Structure is good and appropriate for one file, matching anchor 4; it is not 5 because of minor organization gaps such as the orphaned entity-hierarchy list under 'Chatfuel Overview' with no explanation of how to use it, and the unlabeled step numbering.

4 / 5

Total

16

/

20

Passed

Description

66%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 is functional and appropriately anchored to a distinctive platform name, with an explicit 'Use when' clause. Its weaknesses are generic action language ('Manage data, records, and automate workflows') and sparse natural trigger terms, which leave both specificity and trigger quality at a middling level.

Suggestions

Replace generic phrases with concrete Chatfuel operations, e.g. 'Create and clone chatbots, connect and disconnect Facebook pages, send broadcast messages to users, and manage WhatsApp contacts.'

Broaden trigger terms to cover what users actually say: chatbot, Facebook Messenger bot, broadcast/send message to bot users, WhatsApp contact, connect a page to a bot.

Make the 'Use when' clause more concrete, e.g. 'Use when the user mentions Chatfuel, wants to manage a chatbot, send broadcasts to bot users, or connect a Facebook page to a bot.'

DimensionReasoningScore

Specificity

The description names the domain and lists a few action phrases ('Manage data, records, and automate workflows'), but the actions are generic rather than concrete Chatfuel operations (e.g. no 'send broadcasts', 'create bots', 'connect pages to bots'). This matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) rather than 4, which requires specific actions with only minor coverage gaps, and is above 2 because more than one action is named.

3 / 5

Completeness

Both parts are explicit: what it does ('Manage data, records, and automate workflows') and when to use it ('Use when the user wants to interact with Chatfuel data'). This matches anchor 4 (both what and when, when could be more specific) rather than 5, because the trigger phrase 'interact with Chatfuel data' is generic and lacks concrete trigger scenarios.

4 / 5

Trigger Term Quality

'Chatfuel', 'data', and 'records' are relevant keywords, but common natural terms users would say are missing: 'chatbot', 'bot', 'Messenger', 'Facebook page', 'broadcast', 'WhatsApp'. Anchor 3 (some relevant keywords, missing common variations/synonyms) is the best fit; not 4 because keyword coverage has clear gaps, not 2 because the primary natural term 'Chatfuel' is present.

3 / 5

Distinctiveness Conflict Risk

'Chatfuel' is a distinct named platform with a clear niche; the 'Use when' clause ties triggers specifically to Chatfuel data, so conflict risk with other skills is minimal. This clearly matches anchor 5 rather than 4, which would require some overlap with closely related skills.

5 / 5

Total

15

/

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/chatfuel/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.