SkillAgentSearch skills...

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.

Install / Use

npx skills add heshengtao/super-agent-party --skill sap-extension-creator

Installs into whichever agent you are using.

About this skill
πŸ“„

SKILL.md

Installable skill definition

Quality Score

95/100

Supported Platforms

Universal

Tags

Our assessment of sap-extension-creator

sap-extension-creator scores 95/100 on our quality scale, 407th of 4,700 Development & Engineering skills we index (top 9%).

Its SKILL.md is 24 KB long, well organised into 42 sections with 26 code examples: a thorough specification that gives an agent plenty to work with.

With 2,693 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
30/30
Structure
20/20
Description
15/15
Adoption
15/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 3 months ago, so sap-extension-creator is actively maintained.
  • Our last check on 2026-11-16 found the source still online.
  • It is released under AGPL-3.0, a copyleft license: you can use it, but modified versions you distribute must carry the same license.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit β€” read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-03. Automated pattern scan on 2026-10-03. It catches known dangerous patterns, not every risk β€” read a skill before letting an agent act on it.

sap-extension-creator compared with similar skills

All 4 of these similar skills score higher than sap-extension-creator; compare them before choosing.

SkillScoreStarsUpdatedFormat
sap-extension-creator (this skill)by heshengtao952.7k3mo agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
ai-job-searchby ai-job-search-dev10072.1ktodayCLAUDE.md
claude-howtoby luongnv8910047.3k2d agoCLAUDE.md
lobehubby lobehub10085.6ktodayMCP Server

Frequently asked questions

How do I install sap-extension-creator?
Run npx skills add heshengtao/super-agent-party --skill sap-extension-creator. The install tabs above show the steps for each supported agent.
Which AI agents does sap-extension-creator work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is sap-extension-creator safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is AGPL-3.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is sap-extension-creator still maintained?
The repository was last updated about 3 months ago, so sap-extension-creator is actively maintained.

name: sap-extension-creator description: 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.

SAP Extension Creator

Overview

Create Super Agent Party extensionsβ€”self-contained packages that extend the platform with custom chat UI and tools. Two modes are supported:

  • Static extension: Pure HTML/CSS/JS frontend, served directly by SAP from the extension folder
  • Node.js extension: Full-stack with Express backend, auto-managed by SAP (npm install + node index.js <port>)

Both modes support MCP tool registration (the register_node_extension_mcp protocol message works for ANY extension via WebSocket, despite the "node" in its name).

Quick Decision Tree

User wants to create an extension?
β”œβ”€ Only needs UI (chat, display, simple interactions)? β†’ Static Extension
└─ Needs backend logic (API calls, DB, file processing)? β†’ Node.js Extension

Core Files Every Extension Needs

| File | Required | Purpose | |------|----------|---------| | package.json | βœ… | Metadata, dependencies, window config | | index.html | βœ… | Main UI (full HTML page, single-file app) | | index.js | Node only | Node.js entry point | | node_modules/ | Node only | Auto-installed by SAP via npm install |

Workflow

Step 1: Gather Requirements

Ask the user:

  1. Extension name? (hyphen-case, e.g., my-weather-widget)
  2. Description? (one sentence)
  3. Static or Node.js? (Node.js only if backend logic/server-side code is needed)
  4. For Node.js: what npm dependencies?
  5. Should it register custom tools for the AI? (works in both static and Node.js modes via WebSocket MCP)
  6. GitHub repository URL? (optional, for updates)
  7. Transparent window? (frameless, always-on-top β€” for mini widgets like music controllers)
  8. Default window size? (width/height in pixels)

Step 2: Scaffold the Extension

Use the templates in assets/ as starting points:

  • Static: Copy assets/static-template/
  • Node.js: Copy assets/node-template/

Create the extension directory under the workspace (user will later install it into SAP's extensions/ folder).

Step 3: Write package.json

See references/package-json-spec.md for the complete field reference. Minimum:

{
  "name": "my-extension",
  "version": "1.0.0",
  "description": "What it does",
  "author": "your-name",
  "repository": "https://github.com/user/repo",
  "backupRepository": "https://gitee.com/user/repo",
  "category": "Tools"
}

For Node.js extensions, also include:

{
  "main": "index.js",
  "nodePort": 0,
  "dependencies": { "express": "^5.1.0" }
}

For transparent/frameless widgets (e.g., mini music controllers, floating panels):

{
  "transparent": true,
  "width": 280,
  "height": 80
}

When transparent: true, SAP creates a frameless, transparent, always-on-top window (see main.js open-extension-window handler). Use this for compact overlay widgets.

Step 4: Write index.html

The HTML page is rendered inside an Electron BrowserWindow (either directly or via an iframe). Key patterns:

  • Self-contained: The extension is a single HTML file with all CSS/JS inlined or loaded from CDN. For Node.js extensions, static assets are served from the extension directory.
  • Font Awesome: Use CDN to ensure reliable loading in both static and Node.js modes:
    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css">
    
    Avoid relative paths like ../../fontawesome/ β€” these may work for static extensions but break for Node.js extensions (different serving paths).
  • Dark/Light mode: Always support both (see "Theme & i18n" section below).
  • i18n (Chinese/English): Always support bilingual UI (see "Theme & i18n" section below).
  • WebSocket connection: Connect to ws://host/ws for messaging and MCP.
  • Extension ID: Parse window.location.pathname for /extensions/{ext_id}/.
  • Message rendering: Listen for messages_update and broadcast_messages events.
  • Send user input: Send set_user_input then trigger_send_message.

Step 5: Write index.js (Node.js only)

See references/node-entry-spec.md for the full protocol. The entry point:

  1. Receives a port number via process.argv[2]
  2. Starts an Express server on that port at 127.0.0.1
  3. Serves static files from its own directory
  4. Exposes a /health endpoint for readiness checks
  5. SAP reverse-proxies requests to the extension

Step 6: Implement Tool Registration (optional, works in both modes)

Extensions can register tools that the AI agent can call β€” via WebSocket in the frontend (both static and Node.js). The MCP lifecycle has three mandatory stages:

STARTUP  β†’ ws.onopen         β†’ registerMcpTools()
RUNTIME  β†’ ws.onmessage      β†’ handleMcpCall() when AI calls a tool
SHUTDOWN β†’ window.beforeunload β†’ unregisterMcpTools()

β‘  Register on startup β€” always in ws.onopen, using a dedicated function:

function registerMcpTools() {
  getExtId();
  ws.send(JSON.stringify({
    type: 'register_node_extension_mcp',
    data: {
      ext_id: MY_EXT_ID,
      tools: [{
        name: `${MY_EXT_ID}_my_tool`,
        description: 'What this tool does (use the user\'s language)',
        parameters: {
          type: 'object',
          properties: {
            param1: { type: 'string', description: '...' }
          },
          required: ['param1']
        }
      }]
    }
  }));
}

β‘‘ Handle tool calls β€” the AI agent calls your tool:

async function handleMcpCall(data) {
  const { ext_id, tool_name, tool_params, call_id } = data;
  if (ext_id !== MY_EXT_ID && !tool_name.includes(MY_EXT_ID)) return;
  // ... execute logic, then:
  ws.send(JSON.stringify({
    type: 'mcp_tool_result',
    data: { call_id, result: 'output' }
  }));
}

β‘’ Unregister on shutdown β€” MUST send unregister_node_extension_mcp before the window closes:

function unregisterMcpTools() {
  if (ws && ws.readyState === WebSocket.OPEN) {
    ws.send(JSON.stringify({ type: 'unregister_node_extension_mcp', data: { ext_id: MY_EXT_ID } }));
  }
}
window.addEventListener('beforeunload', () => { unregisterMcpTools(); });

Key rule: Registration and unregistration MUST be in separate named functions (registerMcpTools / unregisterMcpTools), NOT inline code. This makes the lifecycle explicit and easy for AI to understand.

If an extension has no MCP tools, all three functions can be deleted.

See sap-lx-music/index.html for a complete real-world MCP implementation example (static extension with 12+ registered tools).


Theme & i18n (Dark/Light Mode + Bilingual)

Every extension should support dark/light mode and Chinese/English bilingual UI. Do NOT hardcode a single theme color scheme β€” use CSS variables so each extension can have its own identity.

CSS Variable Pattern

Define light theme in :root and override in body.dark:

:root {
  --bg: #ffffff;
  --bg-secondary: #f5f5f5;
  --text: #333333;
  --text-sub: #888888;
  --accent: #ec4141;        /* extension's own brand color */
  --accent-hover: #d73a3a;
  --border: rgba(0,0,0,0.08);
  --transition: 0.3s cubic-bezier(0.25, 0.1, 0.25, 1);
  --font: -apple-system, BlinkMacSystemFont, "SF Pro Display", "Helvetica Neue", sans-serif;
}

body.dark {
  --bg: #2b2b2b;
  --bg-secondary: #222222;
  --text: #e0e0e0;
  --text-sub: #888888;
  --border: rgba(255,255,255,0.06);
}

* { box-sizing: border-box; margin: 0; padding: 0; }
html, body {
  height: 100%; font-family: var(--font);
  background: var(--bg); color: var(--text);
  transition: background var(--transition);
}

Dark Mode Toggle

function initTheme() {
  const saved = localStorage.getItem('myext_dark');
  if (saved === 'dark' || (!saved && matchMedia('(prefers-color-scheme:dark)').matches)) {
    document.body.classList.add('dark');
  }
}

function toggleDarkMode() {
  const isDark = document.body.classList.toggle('dark');
  localStorage.setItem('myext_dark', isDark ? 'dark' : 'light');
}

i18n Pattern

const i18n = {
  zh: {
    welcome: 'ζ¬’θΏŽδ½Ώη”¨ζˆ‘ηš„ζ‰©ε±•',
    send: '发送',
    // ... all UI strings
  },
  en: {
    welcome: 'Welcome to My Extension',
    send: 'Send',
    // ...
  }
};

let lang = localStorage.getItem('myext_lang') || 'zh';
function t(k) { return i18n[lang]?.[k] || i18n.zh[k] || k; }

function toggleLanguage() {
  lang = lang === 'zh' ? 'en' : 'zh';
  localStorage.setItem('myext_lang', lang);
  updateAllTexts();  // re-render all i18n-dependent UI
}

When registering MCP tools, set description and parameters in the current user's language for better AI interaction.


Responsive Design

Every extension should work well across different window sizes. Critical patterns:

Viewport Meta (REQUIRED)

<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no" />

CSS Media Queries

Use breakpoints to adapt layout at small sizes:

@media (max-width: 900px) {
  /* stack layouts vertically, reduce padding */
}

@media (max-width: 600px) {
  /* hide secondary elements, compact controls */
}

Key responsive practices:

  • Use vw units for widths as fallback (e.g., width: 65vw; max-width: 360px)
  • Use flex layouts with flex-wrap that naturally adapt
  • Hide non-essential elements on small screens (display: none)
  • Reduce font sizes and padding at breakpoints

iframe Compatibility

Extensions may be rendered inside an iframe (depending on SAP's configuration). Ensure:

  • Extension ID detection: Use window.location.pathname (works in both direct and iframe contexts):
    function getExtId() {
      try {
        const match = window.location.pathname.match(/\/extensions\/([^\/]+)/);
        return match ? match[1] : 'unknown';
      } catch(e) { return 'unknown'; }
    }
    
  • WebSocket connection: Use location.host (not hardcoded):
    const proto = location.protocol === 'https:' ? 'wss:' : 'ws:';
    ws = new WebSocket(`${proto}//${location.host}/ws`);
    
  • Window close: window.close() works in both direct and iframe contexts
  • Avoid window.top / window.parent assumptions β€” your extension may be the top-level window
  • Font Awesome via CDN ensures icons load regardless of serving path

Transparent Window / Compact Mode

When transparent: true is set in package.json, SAP creates a frameless transparent window. The extension must implement compact mode to work correctly.

How SAP Creates Transparent Windows

From main.js, when extension.transparent is true:

{
  frame: false,
  transparent: true,
  alwaysOnTop: true,
  skipTaskbar: false,
  hasShadow: false,
  backgroundColor: 'rgba(0, 0, 0, 0)',
}

Compact Mode CSS (REQUIRED for transparent extensions)

/* Transparent backgrounds */
body.compact { background: transparent !important; }
html.compact { background: transparent !important; }

/* Drag regions β€” make structural elements draggable for frameless windows */
body.compact header,
body.compact footer,
body.compact #inputBar {
  -webkit-app-region: drag;
}

/* Interactive elements MUST opt-out of drag */
body.compact button,
body.compact input,
body.compact textarea,
body.compact select,
body.compact a,
body.compact .compact-close-btn {
  -webkit-app-region: no-drag;
}

/* Compact close button (red circle, top-right) */
.compact-close-btn { display: none; }
body.compact .compact-close-btn {
  display: flex;
  position: absolute;
  top: 5px; right: 5px;
  width: 

Truncated for display β€” read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars2.7k
CategoryDevelopment
Updated2mo ago
Forks285

Languages

JavaScript

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit β€” see the Safety scan above for what the skill file itself contains.

No cautions
sap-extension-creator β€” Universal Skill: Install & Safety Check | SkillAgent