codyswanngt/plugin-sync-explain
plugins/src/base/skills/plugin-sync-explain/SKILL.md
Read-only diagnostic for Lisa plugin source/generated drift. Compares plugins/src against generated plugins/lisa* status, reports source-not-built, generated-only, and marketplace registration drift, and preserves the working tree.
$ install --global
skillsauthnpx skillsauth add codyswanngt/lisa plugin-sync-explainInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 28, 2026, 3:47 AM21.9s1 file scanned
SKILL.md
- name:
- plugin-sync-explain
- description:
- Read-only diagnostic for Lisa plugin source/generated drift. Compares plugins/src against generated plugins/lisa* status, reports source-not-built, generated-only, and marketplace registration drift, and preserves the working tree.
- allowed-tools:
- ["Bash", "Read"]
Plugin Sync Explain: $ARGUMENTS
/lisa:plugin-sync-explain explains why the plugin sync gate would need attention without mutating the working tree.
Scope
Inspect the current Lisa repository, or an optional path passed as $ARGUMENTS, using scripts/plugin-sync-explain.mjs.
The diagnostic is read-only:
- Do not run
bun run build:plugins. - Do not run
bun run check:plugins. - Do not edit source files, generated plugin artifacts, or
.claude-plugin/marketplace.json. - Do not stash, commit, reset, or clean local changes.
What to Report
Report a concise terminal-first summary with stable classifications:
SOURCE_NOT_BUILT: files underplugins/src/**changed without their generatedplugins/lisa*counterpart.GENERATED_ONLY: files underplugins/lisa*changed without theirplugins/src/**source counterpart.MARKETPLACE_REGISTRATION_DRIFT: a built plugin directory is missing from.claude-plugin/marketplace.json, or a marketplace source points at a missing built directory.OUT_OF_SYNC: source and generated counterparts both changed and need human review.IN_SYNC: no plugin source/generated or marketplace registration drift was detected.
For every finding, include the evidence path and the smallest source-first next action. Prefer bun run build:plugins only after source edits are in the right place, and preserve bun run check:plugins as the final reproducibility gate.
Process
- Resolve the repo path from
$ARGUMENTSor the current directory. - Capture
git status --porcelainbefore the diagnostic. - Run:
If running from the source tree before generated artifacts are rebuilt, use:node plugins/lisa/scripts/plugin-sync-explain.mjs "$REPO_PATH"node plugins/src/base/scripts/plugin-sync-explain.mjs "$REPO_PATH" - Capture
git status --porcelainafter the diagnostic and confirm it is unchanged. - Surface the script output plus the read-only confirmation.
Rules
- Keep this surface aligned with
scripts/check-plugins-sync.sh; it explains the gate but does not replace it. - Treat
plugins/src/**as the source of truth andplugins/lisa*as generated artifacts. - If the diagnostic cannot inspect git status or marketplace JSON, report the error plainly and do not guess.
Related Skills
codyswanngt/plugins/src/harper-fabric/skills/harper-realtime
tools
VerifiedTrustedCommunity
--- name: harper-realtime description: This skill should be used when adding or troubleshooting Harper (HarperDB/Fabric) real-time behavior: MQTT topics, WebSocket resource subscriptions, resource publish/subscribe handlers, SSE-style streaming routes, and local subscriber verification. Pairs with harper-resources, harper-config-yaml, harper-schema-graphql, and harper-build-and-deploy. --- # Harper Realtime ## Overview Harper exposes live data through the same Resource model used for REST and
1SKILL.mdUpdated Jun 13, 2026
codyswanngt/plugins/lisa-harper-fabric/skills/harper-realtime
tools
VerifiedTrustedCommunity
--- name: harper-realtime description: This skill should be used when adding or troubleshooting Harper (HarperDB/Fabric) real-time behavior: MQTT topics, WebSocket resource subscriptions, resource publish/subscribe handlers, SSE-style streaming routes, and local subscriber verification. Pairs with harper-resources, harper-config-yaml, harper-schema-graphql, and harper-build-and-deploy. --- # Harper Realtime ## Overview Harper exposes live data through the same Resource model used for REST and
1SKILL.mdUpdated Jun 13, 2026
codyswanngt/plugins/lisa-harper-fabric-cursor/skills/harper-realtime
tools
VerifiedTrustedCommunity
--- name: harper-realtime description: This skill should be used when adding or troubleshooting Harper (HarperDB/Fabric) real-time behavior: MQTT topics, WebSocket resource subscriptions, resource publish/subscribe handlers, SSE-style streaming routes, and local subscriber verification. Pairs with harper-resources, harper-config-yaml, harper-schema-graphql, and harper-build-and-deploy. --- # Harper Realtime ## Overview Harper exposes live data through the same Resource model used for REST and
1SKILL.mdUpdated Jun 13, 2026
codyswanngt/plugins/lisa-harper-fabric-copilot/skills/harper-realtime
tools
VerifiedTrustedCommunity
--- name: harper-realtime description: This skill should be used when adding or troubleshooting Harper (HarperDB/Fabric) real-time behavior: MQTT topics, WebSocket resource subscriptions, resource publish/subscribe handlers, SSE-style streaming routes, and local subscriber verification. Pairs with harper-resources, harper-config-yaml, harper-schema-graphql, and harper-build-and-deploy. --- # Harper Realtime ## Overview Harper exposes live data through the same Resource model used for REST and
1SKILL.mdUpdated Jun 13, 2026