Skip to content

Self-improving AI Employees for everyone

18.1 KB
Raw Blame
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1920 1080" width="100%" role="img" aria-labelledby="title desc">
<title id="title">Master Skill Editor</title>
<desc id="desc">Source-backed anatomy of the Master Skill editor: built-in and user skill sources flow through WebSocket handlers and TanStack caches into the catalogue and instruction editor, while enabled skills persist in skills_config, expand for a connected agent, and report safe runtime badges back to the exact Master Skill row. Sources: client/src/components/parameterPanel/MasterSkillEditor.tsx; client/src/hooks/useFolderSkills.ts; server/services/skills/handlers.py; server/nodes/skill/master_skill/__init__.py; server/nodes/skill/_expander.py; server/services/skill_runtime.py; server/nodes/skill/master_skill/_events.py; client/src/contexts/WebSocketContext.tsx</desc>
<defs>
  <marker id="arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="8" markerHeight="8" orient="auto"><path d="M0,0 L10,5 L0,10 z" fill="#e8eaed"/></marker>
  <style>
    .title { fill:#e8eaed; font:700 30px Geist,system-ui,sans-serif; }
    .subtitle { fill:#9aa1ac; font:400 18px Geist,system-ui,sans-serif; }
    .group-label { fill:#9aa1ac; font:600 16px 'JetBrains Mono',ui-monospace,monospace; letter-spacing:1.2px; }
    .type-label { fill:#9aa1ac; font:600 16px 'JetBrains Mono',ui-monospace,monospace; letter-spacing:.8px; }
    .node-label { fill:#e8eaed; font:650 20px Geist,system-ui,sans-serif; }
    .node-detail { fill:#9aa1ac; font:400 16px Geist,system-ui,sans-serif; }
    .edge-label { fill:#e8eaed; font:500 16px Geist,system-ui,sans-serif; }
    .edge-protocol { fill:#9aa1ac; font:500 16px 'JetBrains Mono',ui-monospace,monospace; }
    .callout-title { fill:#e8eaed; font:650 18px Geist,system-ui,sans-serif; }
    .callout-text { fill:#9aa1ac; font:400 16px Geist,system-ui,sans-serif; }
    .legend { fill:#9aa1ac; font:500 16px Geist,system-ui,sans-serif; }
  </style>
</defs>
<rect width="1920" height="1080" fill="#0d0f13"/>
<text x="72" y="58" class="title">Master Skill Editor</text>
<text x="72" y="91" class="subtitle">One split panel joins the skill catalogue, authoritative instructions, node configuration, and live retrieval state.</text>
<g data-group-id="skill-sources"><rect x="70" y="130" width="500" height="700" rx="18" fill="#15171c" stroke="#ff79c6" stroke-width="2"/><text x="90" y="162" class="group-label">SKILL SOURCES + WIRE HANDLERS</text></g><g data-group-id="editor-surface"><rect x="610" y="130" width="760" height="700" rx="18" fill="#15171c" stroke="#8be9fd" stroke-width="2"/><text x="630" y="162" class="group-label">MASTER SKILL EDITOR</text></g><g data-group-id="agent-runtime"><rect x="1410" y="130" width="440" height="700" rx="18" fill="#15171c" stroke="#ffb86c" stroke-width="2"/><text x="1430" y="162" class="group-label">CONNECTED AGENT RUNTIME</text></g><g data-relationship-id="handlers-scan-builtins"><title>scan and load metadata + instructions · via filesystem</title><path d="M 320.0 360 L 220 390 L 208 390 L 207.5 430" fill="none" stroke="#e8eaed" stroke-width="2" marker-end="url(#arrow)"/><path d="M 205.0 390.0 L 164.6 390" fill="none" stroke="#9aa1ac" stroke-width="1" stroke-dasharray="3 4" opacity=".7"/><rect x="12.0" y="366.0" width="305.2" height="48" rx="7" fill="#15171c" stroke="#2b2f37"/><text x="164.6" y="387" class="edge-label" text-anchor="middle" textLength="287.2" lengthAdjust="spacingAndGlyphs">scan and load metadata + instructions</text><text x="164.6" y="407" class="edge-protocol" text-anchor="middle">via filesystem</text></g><g data-relationship-id="handlers-crud-user-skills"><title>list and mutate custom skills · via database</title><path d="M 320.0 360 L 430 390 L 433 390 L 432.5 430" fill="none" stroke="#e8eaed" stroke-width="2" marker-end="url(#arrow)"/><path d="M 430.0 390.0 L 520 390" fill="none" stroke="#9aa1ac" stroke-width="1" stroke-dasharray="3 4" opacity=".7"/><rect x="397.8" y="366.0" width="244.39999999999998" height="48" rx="7" fill="#15171c" stroke="#2b2f37"/><text x="520" y="387" class="edge-label" text-anchor="middle" textLength="226.4" lengthAdjust="spacingAndGlyphs">list and mutate custom skills</text><text x="520" y="407" class="edge-protocol" text-anchor="middle">via database</text></g><g data-relationship-id="handlers-refresh-cache"><title>query results and lifecycle invalidation · via WebSocket</title><path d="M 110 280.0 L 90 280 L 90 715 L 110 715.0" fill="none" stroke="#e8eaed" stroke-width="2" marker-end="url(#arrow)"/><rect x="106.0" y="591.0" width="328.0" height="48" rx="7" fill="#15171c" stroke="#2b2f37"/><text x="270" y="612" class="edge-label" text-anchor="middle" textLength="310.0" lengthAdjust="spacingAndGlyphs">query results and lifecycle invalidation</text><text x="270" y="632" class="edge-protocol" text-anchor="middle">via WebSocket</text></g><g data-relationship-id="cache-builds-projection"><title>cached folder, user, and content records</title><path d="M 530 715.0 L 650 695.0" fill="none" stroke="#e8eaed" stroke-width="2" marker-end="url(#arrow)"/><path d="M 590.0 690.0 L 590 852" fill="none" stroke="#9aa1ac" stroke-width="1" stroke-dasharray="3 4" opacity=".7"/><rect x="426.0" y="837.0" width="328.0" height="30" rx="7" fill="#15171c" stroke="#2b2f37"/><text x="590" y="855" class="edge-label" text-anchor="middle" textLength="310.0" lengthAdjust="spacingAndGlyphs">cached folder, user, and content records</text></g><g data-relationship-id="projection-populates-catalogue"><title>render and filter rows</title><path d="M 810.0 620 L 810.0 530" fill="none" stroke="#e8eaed" stroke-width="2" marker-end="url(#arrow)"/><rect x="714.4" y="560.0" width="191.2" height="30" rx="7" fill="#15171c" stroke="#2b2f37"/><text x="810" y="578" class="edge-label" text-anchor="middle" textLength="173.2" lengthAdjust="spacingAndGlyphs">render and filter rows</text></g><g data-relationship-id="catalogue-selects-editor"><title>select skill</title><path d="M 970 365.0 L 1010 365.0" fill="none" stroke="#e8eaed" stroke-width="2" marker-end="url(#arrow)"/><path d="M 990.0 350.0 L 990 139.0" fill="none" stroke="#9aa1ac" stroke-width="1" stroke-dasharray="3 4" opacity=".7"/><rect x="930.0" y="124.0" width="120" height="30" rx="7" fill="#15171c" stroke="#2b2f37"/><text x="990" y="142.0" class="edge-label" text-anchor="middle" textLength="102.0" lengthAdjust="spacingAndGlyphs">select skill</text></g><g data-relationship-id="catalogue-writes-toggle"><title>toggle enabled / keep required</title><path d="M 810.0 530 L 810 570 L 990 570 L 990 695 L 1010 695.0" fill="none" stroke="#e8eaed" stroke-width="2" marker-end="url(#arrow)"/><path d="M 900.0 560.0 L 1080 560" fill="none" stroke="#9aa1ac" stroke-width="1" stroke-dasharray="3 4" opacity=".7"/><rect x="954.0" y="545.0" width="252.0" height="30" rx="7" fill="#15171c" stroke="#2b2f37"/><text x="1080" y="563" class="edge-label" text-anchor="middle" textLength="234.0" lengthAdjust="spacingAndGlyphs">toggle enabled / keep required</text></g><g data-relationship-id="editor-writes-instructions"><title>write instructions + customized flag</title><path d="M 1170.0 530 L 1170.0 620" fill="none" stroke="#e8eaed" stroke-width="2" marker-end="url(#arrow)"/><path d="M 1170.0 575.0 L 1170 845" fill="none" stroke="#9aa1ac" stroke-width="1" stroke-dasharray="3 4" opacity=".7"/><rect x="1021.2" y="830.0" width="297.59999999999997" height="30" rx="7" fill="#15171c" stroke="#2b2f37"/><text x="1170" y="848" class="edge-label" text-anchor="middle" textLength="279.6" lengthAdjust="spacingAndGlyphs">write instructions + customized flag</text></g><g data-relationship-id="editor-user-skill-crud"><title>create / update / delete user skill · via WebSocket</title><path d="M 1170.0 200 L 1170 170 L 320 170 L 320.0 200" fill="none" stroke="#e8eaed" stroke-width="2" stroke-dasharray="10 8" marker-end="url(#arrow)"/><path d="M 750.0 165.0 L 1200 165" fill="none" stroke="#9aa1ac" stroke-width="1" stroke-dasharray="3 4" opacity=".7"/><rect x="1055.0" y="141.0" width="290.0" height="48" rx="7" fill="#15171c" stroke="#2b2f37"/><text x="1200" y="162" class="edge-label" text-anchor="middle" textLength="272.0" lengthAdjust="spacingAndGlyphs">create / update / delete user skill</text><text x="1200" y="182" class="edge-protocol" text-anchor="middle">via WebSocket</text></g><g data-relationship-id="config-expands"><title>expand enabled entries</title><path d="M 1330 695.0 L 1385 695 L 1385 275 L 1450 275.0" fill="none" stroke="#e8eaed" stroke-width="2" marker-end="url(#arrow)"/><path d="M 1385.0 485.0 L 1295 593" fill="none" stroke="#9aa1ac" stroke-width="1" stroke-dasharray="3 4" opacity=".7"/><rect x="1199.4" y="578.0" width="191.2" height="30" rx="7" fill="#15171c" stroke="#2b2f37"/><text x="1295" y="596" class="edge-label" text-anchor="middle" textLength="173.2" lengthAdjust="spacingAndGlyphs">expand enabled entries</text></g><g data-relationship-id="expander-builds-runtime"><title>descriptors + Skill tool catalogue</title><path d="M 1630.0 350 L 1630.0 430" fill="none" stroke="#e8eaed" stroke-width="2" marker-end="url(#arrow)"/><rect x="1488.8" y="375.0" width="282.4" height="30" rx="7" fill="#15171c" stroke="#2b2f37"/><text x="1630" y="393" class="edge-label" text-anchor="middle" textLength="264.4" lengthAdjust="spacingAndGlyphs">descriptors + Skill tool catalogue</text></g><g data-relationship-id="runtime-publishes-status"><title>loading / loaded / used / failed · via node status + CloudEvents</title><path d="M 1630.0 590 L 1630.0 660" fill="none" stroke="#e8eaed" stroke-width="2" marker-end="url(#arrow)"/><rect x="1496.4" y="601.0" width="267.2" height="48" rx="7" fill="#15171c" stroke="#2b2f37"/><text x="1630" y="622" class="edge-label" text-anchor="middle" textLength="249.2" lengthAdjust="spacingAndGlyphs">loading / loaded / used / failed</text><text x="1630" y="642" class="edge-protocol" text-anchor="middle" textLength="249.2" lengthAdjust="spacingAndGlyphs">via node status + CloudEvents</text></g><g data-relationship-id="status-back-to-catalogue"><title>project safe state onto matching row</title><path d="M 1630.0 780 L 1630 840 L 595 840 L 595 365 L 650 365.0" fill="none" stroke="#e8eaed" stroke-width="2" stroke-dasharray="10 8" marker-end="url(#arrow)"/><path d="M 1090.0 835.0 L 1540 835" fill="none" stroke="#9aa1ac" stroke-width="1" stroke-dasharray="3 4" opacity=".7"/><rect x="1391.2" y="820.0" width="297.59999999999997" height="30" rx="7" fill="#15171c" stroke="#2b2f37"/><text x="1540" y="838" class="edge-label" text-anchor="middle" textLength="279.6" lengthAdjust="spacingAndGlyphs">project safe state onto matching row</text></g><g data-component-id="skill-ws-handlers"><title>Skill WebSocket handlers</title><rect x="110" y="200" width="420" height="160" rx="12" fill="#1b1e25" stroke="#bd93f9" stroke-width="2"/><rect x="110" y="200" width="420" height="7" rx="4" fill="#bd93f9"/><text x="128" y="226" class="type-label">SERVICE</text><text x="128" y="252" class="node-label">Skill WebSocket</text><text x="128" y="274" class="node-label">handlers</text><text x="128" y="300" class="node-detail">list / scan / get content</text><text x="128" y="320" class="node-detail">create / update / delete</text><text x="128" y="340" class="node-detail">skill_lifecycle broadcasts</text></g><g data-component-id="builtin-skill-files"><title>Built-in SKILL.md</title><rect x="110" y="430" width="195" height="150" rx="12" fill="#1b1e25" stroke="#ff79c6" stroke-width="2"/><rect x="110" y="430" width="195" height="7" rx="4" fill="#ff79c6"/><text x="128" y="456" class="type-label">SOURCE</text><text x="128" y="482" class="node-label">Built-in</text><text x="128" y="504" class="node-label">SKILL.md</text><text x="128" y="530" class="node-detail">server/skills/*</text><text x="128" y="550" class="node-detail" textLength="159.0" lengthAdjust="spacingAndGlyphs">metadata + instructions</text></g><g data-component-id="user-skill-store"><title>User skill store</title><rect x="335" y="430" width="195" height="150" rx="12" fill="#1b1e25" stroke="#ff79c6" stroke-width="2"/><rect x="335" y="430" width="195" height="7" rx="4" fill="#ff79c6"/><text x="353" y="456" class="type-label">DATABASE</text><text x="353" y="482" class="node-label">User skill</text><text x="353" y="504" class="node-label">store</text><text x="353" y="530" class="node-detail">custom records</text><text x="353" y="550" class="node-detail" textLength="159.0" lengthAdjust="spacingAndGlyphs">display + instructions</text></g><g data-component-id="tanstack-skill-cache"><title>TanStack skill caches</title><rect x="110" y="650" width="420" height="130" rx="12" fill="#1b1e25" stroke="#ff79c6" stroke-width="2"/><rect x="110" y="650" width="420" height="7" rx="4" fill="#ff79c6"/><text x="128" y="676" class="type-label">CLIENT STATE</text><text x="128" y="702" class="node-label">TanStack skill caches</text><text x="128" y="728" class="node-detail">userSkills · folderSkills</text><text x="128" y="748" class="node-detail">skillContent by name</text></g><g data-component-id="skill-catalogue-pane"><title>Skills catalogue pane</title><rect x="650" y="200" width="320" height="330" rx="12" fill="#1b1e25" stroke="#8be9fd" stroke-width="2"/><rect x="650" y="200" width="320" height="7" rx="4" fill="#8be9fd"/><text x="668" y="226" class="type-label">INTERFACE</text><text x="668" y="252" class="node-label">Skills catalogue</text><text x="668" y="274" class="node-label">pane</text><text x="668" y="300" class="node-detail">folder selector + search</text><text x="668" y="320" class="node-detail">enable / required / custom</text><text x="668" y="340" class="node-detail">Loading · Loaded · Failed</text><text x="668" y="360" class="node-detail">enabled count + create</text></g><g data-component-id="instructions-editor-pane"><title>Instructions editor pane</title><rect x="1010" y="200" width="320" height="330" rx="12" fill="#1b1e25" stroke="#8be9fd" stroke-width="2"/><rect x="1010" y="200" width="320" height="7" rx="4" fill="#8be9fd"/><text x="1028" y="226" class="type-label">INTERFACE</text><text x="1028" y="252" class="node-label">Instructions editor</text><text x="1028" y="274" class="node-label">pane</text><text x="1028" y="300" class="node-detail">authoritative markdown</text><text x="1028" y="320" class="node-detail">create / edit / delete</text><text x="1028" y="340" class="node-detail">reset built-in default</text><text x="1028" y="360" class="node-detail">customized state</text></g><g data-component-id="query-projection"><title>Catalogue projection</title><rect x="650" y="620" width="320" height="150" rx="12" fill="#1b1e25" stroke="#9aa1ac" stroke-width="2"/><rect x="650" y="620" width="320" height="7" rx="4" fill="#9aa1ac"/><text x="668" y="646" class="type-label">VIEW MODEL</text><text x="668" y="672" class="node-label">Catalogue projection</text><text x="668" y="698" class="node-detail">folder rows + user rows</text><text x="668" y="718" class="node-detail">selected skill buffer</text></g><g data-component-id="skills-config"><title>Master Skill skills_config</title><rect x="1010" y="620" width="320" height="150" rx="12" fill="#1b1e25" stroke="#f1fa8c" stroke-width="2"/><rect x="1010" y="620" width="320" height="7" rx="4" fill="#f1fa8c"/><text x="1028" y="646" class="type-label">NODE PARAMS</text><text x="1028" y="672" class="node-label">Master Skill</text><text x="1028" y="694" class="node-label">skills_config</text><text x="1028" y="720" class="node-detail">enabled · instructions</text><text x="1028" y="740" class="node-detail">isCustomized · required</text></g><g data-component-id="master-skill-expander"><title>Master Skill expander</title><rect x="1450" y="200" width="360" height="150" rx="12" fill="#1b1e25" stroke="#ffb86c" stroke-width="2"/><rect x="1450" y="200" width="360" height="7" rx="4" fill="#ffb86c"/><text x="1468" y="226" class="type-label">RUNTIME</text><text x="1468" y="252" class="node-label">Master Skill</text><text x="1468" y="274" class="node-label">expander</text><text x="1468" y="300" class="node-detail">enabled entries only</text><text x="1468" y="320" class="node-detail">per-skill descriptors</text></g><g data-component-id="agent-skill-runtime"><title>Agent Skill runtime</title><rect x="1450" y="430" width="360" height="160" rx="12" fill="#1b1e25" stroke="#bd93f9" stroke-width="2"/><rect x="1450" y="430" width="360" height="7" rx="4" fill="#bd93f9"/><text x="1468" y="456" class="type-label">TOOL RUNTIME</text><text x="1468" y="482" class="node-label">Agent Skill runtime</text><text x="1468" y="508" class="node-detail">progressive load</text><text x="1468" y="528" class="node-detail">declared resources</text><text x="1468" y="548" class="node-detail">bounded safe events</text></g><g data-component-id="skill-status-projection"><title>Exact-node status projection</title><rect x="1450" y="660" width="360" height="120" rx="12" fill="#1b1e25" stroke="#ff79c6" stroke-width="2"/><rect x="1450" y="660" width="360" height="7" rx="4" fill="#ff79c6"/><text x="1468" y="686" class="type-label">OBSERVABILITY</text><text x="1468" y="712" class="node-label">Exact-node status</text><text x="1468" y="734" class="node-label">projection</text><text x="1468" y="760" class="node-detail">active_skills / last_skills</text></g><g data-callout-id="master-skill-invariant"><rect x="70" y="880" width="1780" height="90" rx="10" fill="#1b1e25" stroke="#f1fa8c" stroke-width="2" stroke-dasharray="7 6"/><text x="86" y="910" class="callout-title">Configuration is authoritative; observability is sanitized</text><text x="86" y="936" class="callout-text">skills_config keeps the enabled flag and instruction body used by the connected agent.</text><text x="86" y="958" class="callout-text">Runtime events expose names and states only—never prompts, arguments, results, secrets, or raw exceptions.</text></g>
<g aria-label="Legend"><circle cx="72" cy="1038" r="7" fill="#bd93f9"/><text x="86" y="1044" class="legend">Agents / system</text><circle cx="317" cy="1038" r="7" fill="#8be9fd"/><text x="331" y="1044" class="legend">Models / interfaces</text><circle cx="562" cy="1038" r="7" fill="#50fa7b"/><text x="576" y="1044" class="legend">Tools / results</text><circle cx="807" cy="1038" r="7" fill="#ff79c6"/><text x="821" y="1044" class="legend">Triggers / events</text><circle cx="1052" cy="1038" r="7" fill="#ffb86c"/><text x="1066" y="1044" class="legend">Workflow / runtime</text><circle cx="1297" cy="1038" r="7" fill="#f1fa8c"/><text x="1311" y="1044" class="legend">Security note</text></g>
</svg>