codyswanngt/plugin-sync-explain
plugins/lisa/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 27, 2026, 4:16 AM36.6s2 files 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/lisa-wiki-onboard-me
documentation
VerifiedTrustedCommunity
Onboard a user to the project via its LLM Wiki. Interviews the user about themselves in relation to the project, captures that to project-scoped memory only, then gives a guided tour of what the project is and sample questions they can ask. Use when someone is new to the project or asks to be onboarded. Read-mostly — it does not open PRs or write PII into the wiki.
1SKILL.mdUpdated Jun 5, 2026
codyswanngt/lisa-wiki-migrate
documentation
VerifiedTrustedCommunity
Migrate an existing, hand-rolled wiki implementation onto the lisa-wiki kernel — phased and compatibility-first, with a strict no-loss guarantee. Use when adopting lisa-wiki in a repo that already has its own wiki/, ingest skills, docs, or roles. Renaming things into the canonical shape is fine; losing functionality or data is not. Ends by running /doctor.
1SKILL.mdUpdated Jun 5, 2026
codyswanngt/lisa-wiki-lint
development
VerifiedTrustedCommunity
Health-check the LLM Wiki. Reports orphan pages, contradictions, stale claims, broken internal links, missing index/log coverage, structure-manifest violations, and secret/tenant leaks. Use periodically or before hardening a wiki. Read-only — it reports findings, it does not fix them.
1SKILL.mdUpdated Jun 5, 2026
codyswanngt/lisa-wiki-ingest
testing
VerifiedTrustedCommunity
Ingest source material into the LLM Wiki. With an argument (URL, file path, or prompt) it ingests that one source; with no argument it runs a full ingest across every enabled non-external-write source. Routes to the right connector, then runs the ordered pipeline (source note → synthesis → index → log → verify → state → commit/PR). Use whenever new knowledge should enter the wiki.
1SKILL.mdUpdated Jun 5, 2026