CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

charisma

Charisma integration. Manage data, records, and automate workflows. Use when the user wants to interact with Charisma 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

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/charisma/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

A largely actionable, command-driven integration guide whose strongest part is the connection state-handling loop. It is held back by broken step cross-references ('Step 2' does not exist), an empty Popular actions section, filler prose, and inconsistent CLI invocation between 'membrane' and 'npx @membranehq/cli'.

Suggestions

Fix the workflow sequencing: 'skip to **Step 2**' appears twice but no Step 2 exists, and subsection '1b' has no '1a' — relabel the sections as a coherent numbered sequence (install → login → connect → discover → run → proxy).

Fill or remove the 'Popular actions' section: it currently contains no example actions, only a restatement of the search command; listing 3-5 concrete Charisma actions (e.g. story/character operations) with sample inputs would cover common cases.

Trim filler ('Use action names and parameters as needed', the audience intro paragraph, 'This is the fastest way to get a connection') and standardize on one CLI invocation form ('membrane' vs 'npx @membranehq/cli').

DimensionReasoningScore

Conciseness

The bulk is lean, command-first content (install/login/connection/action commands, a flags table), but it includes unnecessary padding: the intro paragraph about who uses Charisma ('used by writers, game developers, and educators'), the marketing line 'Membrane handles authentication... so you can focus on the integration logic rather than auth plumbing', 'This is the fastest way to get a connection', and the meaningless filler 'Use action names and parameters as needed.'

3 / 5

Actionability

Mostly executable, copy-paste-ready commands with concrete flags ('membrane connection ensure "https://charisma.ai/" --json', 'membrane action run <actionId> --connectionId=... --input \'{...}\' --json') and a full proxy options table. Minor gaps: the 'Popular actions' section contains no actual example actions (it just restates the search command), and the CLI is invoked inconsistently ('membrane ...' vs 'npx @membranehq/cli ...').

4 / 5

Workflow Clarity

A rough sequence exists (install → login → connection ensure → search → run → proxy) with a genuinely good state-handling loop (READY / BUILDING polling / CLIENT_ACTION_REQUIRED / error states), but the numbered workflow is broken: two instructions say 'skip to **Step 2**' yet no Step 2 is labeled anywhere, and section '1b' has no '1a'. Validation checkpoints after running actions are also absent.

3 / 5

Progressive Disclosure

Single-file skill with no bundle files (references/, scripts/, assets/ do not exist) and reasonable section headers, but organization is uneven: a contentless 'Charisma Overview' (bare 'Story/Character/Character Template' list), an empty 'Popular actions' section, and 'Searching for actions' placed after the connection subsection but before the sections it introduces. Content is short enough that the single file is acceptable, but the structure could be better organized.

3 / 5

Total

13

/

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.

A correctly structured description (domain + actions + explicit 'Use when' clause) whose substance is generic boilerplate. Its distinctiveness rests almost entirely on the 'Charisma' brand name, while the capability and trigger language ('manage data, records', 'automate workflows') could describe any integration and omits what Charisma actually does — characters, dialogue, and interactive stories.

Suggestions

Replace 'Manage data, records, and automate workflows' with Charisma-specific capabilities, e.g. 'Create and manage AI-powered characters, write dialogue, and build branching interactive stories'.

Add natural trigger terms and synonyms users would actually say: 'characters', 'interactive stories', 'dialogue', 'branching storylines', 'charisma.ai'.

Make the 'Use when' clause concrete instead of circular, e.g. 'Use when the user mentions Charisma, wants to create interactive characters or stories, or needs to work with charisma.ai data.'

DimensionReasoningScore

Specificity

The description names the domain (Charisma) but its actions are generic: 'Manage data, records, and automate workflows' could apply to almost any integration — matching 'Names the domain but actions are minimal or generic' ('Processes PDF files'). It is above score 1 because the domain is named and some actions are listed, but far below 3-4 since no Charisma-specific capability (characters, dialogue, stories) is mentioned.

2 / 5

Completeness

Both parts are present: a 'what' ('Manage data, records, and automate workflows') and an explicit 'Use when...' clause ('Use when the user wants to interact with Charisma data'), mirroring anchor 4 ('Extract text from PDFs and fill forms. Use when working with PDF files.'). Not 5 because the 'when' is circular ('interact with Charisma data' restates the skill rather than naming concrete triggers), and the 'what' is generic; not 3 because the 'when' is explicit, not merely implied.

4 / 5

Trigger Term Quality

'Charisma' is the one strong natural trigger a user would actually say, but the description misses the common variations and synonyms users would use — 'characters', 'AI characters', 'interactive stories', 'dialogue', 'branching storylines', 'charisma.ai' — matching 'Some relevant keywords but missing common variations or synonyms' ('Works with PDF files').

3 / 5

Distinctiveness Conflict Risk

The proper noun 'Charisma' gives a clear niche trigger with minimal conflict risk, but the surrounding generic text ('Manage data, records, and automate workflows') overlaps with any data-integration skill — fitting 'Mostly distinct; minor overlap risk with closely related skills'. Not 5 because only the brand name distinguishes it; strip 'Charisma' and the description could trigger for virtually any data tool.

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