Skip to content

feat: sync LoT/broker skills from coreflux-skills - #7

Merged
HugoAVaz merged 7 commits into
CorefluxCommunity:mainfrom
vitorbabo-cf:feat/sync-coreflux-skills
Oct 20, 2026
Merged

HugoAVaz merged 7 commits into
CorefluxCommunity:mainfrom
vitorbabo-cf:feat/sync-coreflux-skills

Conversation

@vitorbabo-cf

Copy link
Copy Markdown
Contributor

Summary

The plugin stops carrying its own drifted copies of the LoT/broker skills. It now ships a pinned copy of CorefluxCommunity/coreflux-skills, which is generated from the broker's skill sources and tagged per broker release.

  • Synced skills (tag 2.21.16-rc.186): broker-tools, lot-actions, lot-models, lot-routes, lot-rules, lot-agents, lot-things, lot-panels, lot-themes, python-scripts.
  • scripts/sync-skills.mjs: npm run skills:sync -- --ref <tag> moves the pin, which is recorded as brokerVersion in skills/skills.json. npm run skills:check runs in CI and the release flow, and fails if the bundle differs from the pinned tag. Fixes go to the broker, not here.
  • Removed: the hand-written lot-authoring, broker-commands, broker-observability, broker-security and lot-projects skills. Several of their claims were wrong against the broker, including Python import blocklists, USER HAS "AllowedSubscribe", user SubscribeSys rules, METHOD/SWITCH keywords and a number of route settings.
  • New plugin-owned coreflux-cursor-tools skill: the shared skills name the broker's own MCP tools (deploy_lot, validate_lot, diagnose, …), and this skill maps them to this plugin's tools.
  • Updated to the new skill names: rules, agents, commands and the session hook. /coreflux-secure no longer recommends user SubscribeSys rules, which are never consulted.
  • check-sources: the "only mention tools this server exposes" check skips the synced skills, which describe the broker's tool surfaces on purpose.
  • lot_deploy / lotnb_deploy now deploy DEFINE THING: every Thing block, templates included, goes as one -addThing after rules, matching the broker's deploy and folder loader. lot_remove takes THING.

Stacked on #6

This branch merges feat/ENG-426/lint-define-agent (#6), which adds DEFINE AGENT deploy and lint. Merge #6 first; until then this PR's diff includes its changes.

Content still missing from the broker skills

The guidance the old skills had that the broker lacked (the raw MQTT command surface and reply format, the $SYS topic map, the troubleshooting checklist, users and secrets, projects and .lotnb, and LoT trigger and route examples) is being added to the broker as a new broker-operations skill plus edits to the LoT skills. It reaches this plugin with the next coreflux-skills tag, through npm run skills:sync -- --ref <tag>.

Test plan

  • npm run ci: validate, check-sources, skills:check, 74 unit tests
  • skills:check fails on a hand-edited synced file
  • CI integration job against a real broker

🤖 Generated with Claude Code

vitorbabo-cf and others added 5 commits October 16, 2026 00:02
…rning

lot_lint (Cursor plugin MCP) treated DEFINE AGENT as unknown. Mirror the
broker parser: USES LLM ROUTE|CONNECTOR first, required DEFAULT_USER,
ADD TOOL "name" with TOPICS|TARGET|LEVEL, deploy as -addAgent after routes.
Also skip the missing-AS-TRIGGER warning when a model inherits via FROM.
…tten copies

The plugin's skills are now a pinned copy of CorefluxCommunity/coreflux-skills
(tag 2.21.16-rc.186), which is generated from the broker. scripts/sync-skills.mjs
updates the copy (npm run skills:sync -- --ref <tag>) and --check fails CI on drift.
The hand-written lot-authoring, broker-commands, broker-observability,
broker-security and lot-projects skills are removed; a plugin-owned
coreflux-cursor-tools skill maps the broker tool names in the shared skills to
this plugin's MCP tools. Rules, agents, commands, the session hook and docs point
at the new skill names.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The synced skills teach agents and things, but lot_deploy refused both. Agents
deploy with -addAgent after routes (they need their LLM connector); every
DEFINE THING block, templates included, goes as one -addThing after rules, the
way the broker's own deploy and folder loader group them. lot_remove takes
AGENT and THING.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…to feat/sync-coreflux-skills

# Conflicts:
#	plugins/coreflux/scripts/mcp/coreflux-mqtt-mcp.mjs
#	plugins/coreflux/scripts/mcp/lib/lot.mjs
#	plugins/coreflux/test/lot.test.mjs
@github-actions github-actions Bot added area: mcp-server coreflux-broker MCP server and MQTT client area: hooks Cursor hooks and destructive-command guards area: skills Skills, rules, agents, commands area: tests Test suites and fixtures area: ci Workflows and repo tooling area: docs READMEs and documentation labels Oct 19, 2026
vitorbabo-cf and others added 2 commits October 19, 2026 14:29
…ools

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@HugoAVaz
HugoAVaz merged commit c1a697b into CorefluxCommunity:main Oct 20, 2026
11 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: ci Workflows and repo tooling area: docs READMEs and documentation area: hooks Cursor hooks and destructive-command guards area: mcp-server coreflux-broker MCP server and MQTT client area: skills Skills, rules, agents, commands area: tests Test suites and fixtures

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants