sap-extension-creator

Create Super Agent Party (SAP) extensions. This skill should be used when users want to create, build, or scaffold a new extension for Super Agent Party - including static HTML extensions (pure frontend) and Node.js backend extensions. Triggers on requests like "create a new SAP extension", "build an extension for Super Agent Party", "scaffold a plugin", "make a chat UI extension", or when working with sap extension projects.

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

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

Highly actionable and well-structured with real templates and references, but the SKILL.md body is long and inlines large reference-grade material (notably the /simple_chat API and streaming implementation) that would be better split out, and the workflow lacks explicit verification checkpoints.

Suggestions

Add a final workflow step that validates the scaffolded extension (e.g., confirm SAP loads it, hit the /health endpoint, verify MCP tools register via mcp_registered) so errors are caught early.

Move the full /simple_chat API reference and streaming implementation into a references/simple-chat-api.md file, keeping only a short usage snippet and a pointer in SKILL.md to reduce token load.

Trim basic explanations Claude already knows (e.g., why window.open() is blocked, what viewport meta does) and consolidate the duplicate Font Awesome CDN guidance that appears in multiple sections.

Dimension	Reasoning	Score
Conciseness	The body is dense and mostly SAP-specific protocol detail Claude would not know, but it is very long (~700 lines) with full inline blocks (the /simple_chat streaming implementation, complete CSS theme/compact-mode blocks) that could be tightened or moved to references, plus a few over-explanations of basics like popup blockers.	3 / 5
Actionability	Provides abundant copy-paste-ready, executable code: package.json snippets, the full registerMcpTools/handleMcpCall/unregisterMcpTools lifecycle, CSS variable and compact-mode CSS, fetch and async-generator streaming examples covering the common cases.	5 / 5
Workflow Clarity	A clear six-step sequence (Gather → Scaffold → package.json → index.html → index.js → Tool registration) is present, but there are no explicit validation or verification checkpoints (e.g., load the extension in SAP, confirm /health responds, test MCP registration), leaving the workflow without feedback loops.	3 / 5
Progressive Disclosure	Good structure with real bundle files (assets/static-template, assets/node-template, references/package-json-spec.md, references/node-entry-spec.md) clearly signaled and one level deep, though sizable content like the full /simple_chat API and theme/i18n patterns is inlined rather than split into reference files.	4 / 5
	Total	15 / 20 Passed

Description

95%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 strong, well-structured description that clearly states the skill's purpose and gives explicit, natural-language triggers in third person. The only minor weakness is that the action verbs cluster around synonyms rather than enumerating distinct capabilities.

Dimension	Reasoning	Score
Specificity	Names the SAP domain and several concrete actions ('create, build, or scaffold a new extension') plus the static HTML vs Node.js backend distinction, but the listed verbs are largely synonyms so coverage is broad rather than deep.	4 / 5
Completeness	Explicitly answers both what ('Create Super Agent Party (SAP) extensions... static HTML extensions and Node.js backend extensions') and when ('This skill should be used when users want to create, build, or scaffold... Triggers on requests like...') with concrete trigger phrases, in third person.	5 / 5
Trigger Term Quality	Provides comprehensive natural trigger phrases users would actually say ('create a new SAP extension', 'build an extension for Super Agent Party', 'scaffold a plugin', 'make a chat UI extension') including synonyms.	5 / 5
Distinctiveness Conflict Risk	Targets a clear niche (Super Agent Party extensions) with product-specific triggers, making conflict with other skills minimal.	5 / 5
	Total	19 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (719 lines); consider splitting into references/ and linking	Warning

	Total	15 / 16 Passed

Repository: heshengtao/super-agent-party
Path: skills/sap-extension-creator/SKILL.md
Commit: b3af7a0

Reviewed: 12 days ago

Table of Contents

Discovery Implementation Validation

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.