CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

burp-suite

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

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/burp-suite/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 content is a solid, actionable guide to driving Burp Suite through the Membrane CLI, with real commands, an explicit connection-state checkpoint flow, and a sensible proxy fallback. Its weaknesses are wasted tokens (an intro explaining what Burp Suite is, a bare tool-name list, a duplicated command), broken step cross-references, and no progressive disclosure structure for detail that would fit reference files.

Suggestions

Cut the "Burp Suite is a popular set of tools..." intro paragraph and the ~20-item bare tool-name list — this is background Claude already knows and adds no guidance value.

Fix the broken "Step 2" cross-references (referenced twice but never defined) by numbering the workflow coherently, e.g. Step 1: connect, Step 2: discover and run actions.

De-duplicate the `action list` command shown in both "Searching for actions" and "Popular actions", and move the clientAction state-machine detail and `membrane request` flags table into a reference file linked from the body.

DimensionReasoningScore

Conciseness

The body opens by explaining what Burp Suite is ("Burp Suite is a popular set of tools used for web application security testing... It acts as a proxy, allowing users to intercept and manipulate HTTP traffic") — knowledge Claude already has — and includes a ~20-item bullet list of bare tool names with no guidance value. The `action list` command is also duplicated in both "Searching for actions" and "Popular actions". Anchor 3 fits; not 2 because the padding is localized and the CLI guidance itself is efficient.

3 / 5

Actionability

Concrete, copy-pasteable commands throughout: `npm install -g @membranehq/cli@latest`, `membrane connection ensure "https://portswigger.net/burp" --json`, `membrane action run <actionId> --input '{"key": "value"}' --json`, plus a full flags table for `membrane request`. Not 5 because no Burp-specific action examples (e.g., listing scan issues or reading proxy history) are shown, so the app's common cases aren't covered; not 3 because the guidance is executable, not pseudocode.

4 / 5

Workflow Clarity

A clear sequence (install → login → connection ensure → poll state → handle clientAction → discover/run actions → proxy fallback) with explicit state checkpoints (READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR) and a poll-again loop after user actions. Not 5 because "skip to **Step 2**" is referenced twice but no Step 2 exists in the document (the only numbered heading is "1b"), and there is no validation guidance after running an action; not 3 because checkpoints are explicit rather than missing.

4 / 5

Progressive Disclosure

No bundle files exist and the single-file body is ~140 lines with clear sections, but the clientAction state-machine detail, the proxy flags table, and the tool-name overview list are inline material that belongs in a reference file, and there is no navigation to deeper material at all. Anchor 3 (some structure, could be better organized); not 4 given the inlined detail and absence of any reference pointers.

3 / 5

Total

14

/

20

Passed

Description

61%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 correctly anchors the skill to a distinctive product (Burp Suite) and includes an explicit "Use when" clause, but its capability statement is generic filler. "Manage data, records, and automate workflows" could describe almost any integration and gives no sense of what can actually be done with Burp Suite.

Suggestions

Replace "Manage data, records, and automate workflows" with concrete Burp Suite capabilities, e.g. "Run and monitor scans, retrieve and analyze scan issues, read proxy traffic history, and configure Burp tools".

Add natural trigger terms users would actually say — "portswigger", "web application security testing", "intercept HTTP requests", "pentest proxy" — rather than repeating "Burp Suite data".

Make the "Use when" clause describe triggering situations (e.g. "Use when the user mentions Burp Suite, PortSwigger, or wants to analyze scan results or proxy traffic") instead of restating the domain.

DimensionReasoningScore

Specificity

"Burp Suite integration" names the domain, but the stated actions — "Manage data, records, and automate workflows" — are generic data-management verbs with no Burp-specific concrete action (scanning, reading proxy history, retrieving issues). This matches anchor 2 (domain named, actions minimal or generic), not 3, since no concrete capabilities are enumerated.

2 / 5

Completeness

Both an explicit "what" ("Manage data, records, and automate workflows") and an explicit "when" ("Use when the user wants to interact with Burp Suite data") are present. Not 5 because the "when" clause is circular — it restates the domain instead of giving concrete trigger phrases — and the "what" is vague; not 3 because the "Use when" trigger guidance is explicit, not weakly implied.

4 / 5

Trigger Term Quality

"Burp Suite" is the natural product-name keyword users would say, but common variations and synonyms (portswigger, web application security testing, intercepting requests, pentest proxy) are absent. Good fit for anchor 3; not 2 because the keyword is specific rather than generic, not 4 because coverage is limited to the product name alone.

3 / 5

Distinctiveness Conflict Risk

"Burp Suite" is a clear niche product name that no other plausible skill would trigger for, and the "Use when" clause ties usage to Burp Suite specifically. Only a minor generic tail ("Manage data, records"), so anchor 5 (clear niche, minimal conflict risk) is the best fit.

5 / 5

Total

14

/

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/burp-suite/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.