Skip to content

feat: run the skills recipes without MSBuild - #56

Merged
kieronlanning merged 3 commits into
mainfrom
feat/skills-without-msbuild
Nov 17, 2026
Merged

kieronlanning merged 3 commits into
mainfrom
feat/skills-without-msbuild

Conversation

@kieronlanning

Copy link
Copy Markdown
Contributor

Summary

The skills-* recipes no longer go through MSBuild. They run skills.mts (Bun or Deno), or its generated skills.mjs (Node), from the repository root, with no solution, restore or build involved.

  • Faster: just skills-check takes 0.4 s instead of 5 s on this repository's warm 8-project solution.
  • Works when the build is broken, which is when new or updated skills may be what fixes it.
  • Settings move to the Skills section of .config/purview-build-sdk.json. A recipe option (for example --agents) beats a PURVIEW_SKILLS_* environment variable, which beats the file. New diagnostics: PRSKL0018 (invalid file, error) and PRSKL0019 (unknown key, warning).
  • skills.mjs is generated from skills.mts by Node's own type stripper (just skills-script-sync). A test fails if the two drift apart.
  • Dry-run fix: just skills-update --dry-run now removes nothing in its fix step.

Breaking changes (released as 2.2.0)

Removed: the InstallPurviewSkills, UpdatePurviewSkills, CheckPurviewSkills and FixPurviewSkills targets, the solution-leader election behind them, eight PurviewSkills* properties (Agents, Runner, RunnerCandidates, Package, Command, Source, LockFile, DryRun) and the PurviewSkillsAgentDirectory items. PRSKL0003 and PRSKL0009 are retired.

ValidatePurviewSkills (the pack-time check, PRSKL0005) and the properties it reads are unchanged.

Migration: copy skills.just, skills.mts and skills.mjs from skills/purview-buildsdk-justfile/assets/just/ into .build/just/, and move any removed property into .config/purview-build-sdk.json. The skill-installation skill has a property-to-setting table.

Breaking removals shipped in a minor before (1.3.0, 1.3.1), so this follows that precedent. Bump to 3.0.0 instead if preferred.

Docs

README, AGENTS.md, the wiki (Agent Skills, Configuration Reference, Justfile, Home, Performance) and every affected skill are updated, following the docs-sync skill.

Validation

  • just test: 1716 passed, 0 failed, 0 skipped (.NET 10 and 11). The script tests ran under Node, Bun and Deno.
  • just lint-check, just skills-validate, just skills-script-check and just version-sync-check all pass.
  • Only Windows was run locally. CI covers Linux.

The skills-* recipes now run skills.mts (Bun or Deno) or its generated
skills.mjs (Node) instead of dotnet msbuild against the solution. No
solution, restore or build is involved, so they take 0.4 s instead of 5 s
and work when the build is broken.

Settings move to the Skills section of .config/purview-build-sdk.json,
overridable by recipe options and PURVIEW_SKILLS_* variables. A dry-run
fix now reports and removes nothing.

BREAKING CHANGE: InstallPurviewSkills, UpdatePurviewSkills,
CheckPurviewSkills and FixPurviewSkills are removed, with the
PurviewSkillsAgents, PurviewSkillsRunner, PurviewSkillsRunnerCandidates,
PurviewSkillsPackage, PurviewSkillsCommand, PurviewSkillsSource,
PurviewSkillsLockFile and PurviewSkillsDryRun properties and the
PurviewSkillsAgentDirectory items. PRSKL0003 and PRSKL0009 are retired.
Updates the README, AGENTS.md, the wiki and every affected skill for the
script-based skills recipes and .config/purview-build-sdk.json, with a
mapping from each removed PurviewSkills* property to its new setting.
@kieronlanning
kieronlanning merged commit 2a3b92f into main Nov 17, 2026
5 checks passed
@kieronlanning
kieronlanning deleted the feat/skills-without-msbuild branch November 17, 2026 12:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant