Skip to content

Powercademy/powercademy-skills / plugins/workstation/skills/check-setup

check-setup

Verified

Diagnose and repair an existing Power Platform development toolchain - CLIs, auth profiles, agent runtimes, plugins, MCP wiring - finding what's broken, outdated or misconfigured, repairing it with consent, and ending with a readiness card. Trigger whenever the user says "check my setup", "is my setup ok", "something's broken", "doctor", "my auth is a mess", "which account am I signed in as", "why isn't pac working", "wrong tenant", "is anything out of date", "my plugins aren't loading", or hits any environment, tooling or authentication error while doing Power Platform work. Also trigger when another skill finds a tool that exists but doesn't work. For a fresh machine or adding a workload, setup-workstation runs instead - this skill checks and repairs what's already there. If the task is diagnosing or repairing the local toolchain, trigger. When in doubt, trigger.

FileKindSize
SKILL.mdskill md8.5 KB
---
name: check-setup
description: >
  Diagnose and repair an existing Power Platform development toolchain - CLIs, auth profiles, agent runtimes, plugins, MCP wiring - finding what's broken, outdated or misconfigured, repairing it with consent, and ending with a readiness card. Trigger whenever the user says "check my setup", "is my setup ok", "something's broken", "doctor", "my auth is a mess", "which account am I signed in as", "why isn't pac working", "wrong tenant", "is anything out of date", "my plugins aren't loading", or hits any environment, tooling or authentication error while doing Power Platform work. Also trigger when another skill finds a tool that exists but doesn't work. For a fresh machine or adding a workload, setup-workstation runs instead - this skill checks and repairs what's already there. If the task is diagnosing or repairing the local toolchain, trigger. When in doubt, trigger.
---

# Check setup — diagnose and repair

`setup-workstation` builds the machine. This skill is for afterwards: when
something stops working, goes stale, or nobody's sure which tenant they're
signed into. It diagnoses everything first, repairs with consent, and proves the
repair worked.

**What to check comes from `${PLUGIN_ROOT}/shared/toolchain-manifest.json`** —
the same source of truth setup-workstation installs from, so the two can never
disagree about what "set up" means. Read it before running checks.

---

## Posture

- **Diagnose everything before repairing anything.** Run all checks, then show
  one findings table — not fix-check-fix-check whiplash.
- **Repair, don't provision.** Broken, outdated, shimmed, misconfigured, stale
  auth — those are yours. **Missing items and new workloads are
  setup-workstation's job**: list them as findings and hand over ("3 items
  aren't installed — run setup-workstation to add them").
- **Repair with consent, in one batch.** On a customer's machine, never act
  silently.
- **The user never types a command.** Only browser sign-ins and admin-held
  permissions stay with them.
- **A repair isn't done until its check passes.**

---

## The check-up

Five layers. Exact commands live in the manifest and in
`${PLUGIN_ROOT}/shared/microsoft-refs.md`.

### Layer 1 — tools

For every manifest item the machine *has*: does its check pass, and does it meet
`min`? Classify as ✅ ready · ⬆ outdated · 🧩 shim · ⬜ missing (→ setup-workstation).

**Present on PATH is not the same as working.** Managed deployments (Intune,
MSI) often install a `pac.cmd` **shim** with no CLI behind it: `pac` resolves,
then every real command fails with *"No Microsoft.PowerApps.CLI has been
installed."* Always run the real check command. The repair — `pac install
latest` — is **user-scoped and needs no admin**, so it's self-service even on a
locked-down device. Apply the same scepticism to anything a managed device
claims to have.

**Known failure signatures live in the manifest.** If a check's output matches
`failIfOutputMatches` (the shim) or an entry in the check's `diagnose` list,
run the `repair` it names — e.g. pac's *"You must install .NET to run this
application"* on macOS/Linux means .NET sits outside its default folder and
`DOTNET_ROOT` must be set. A repair's `setEnv` applies to the current session
too, so the re-check can pass before a new terminal is opened.

**Outdated is a finding in its own right.** Node below the manifest's minimum,
Copilot CLI below the plugin-command floor, .NET below what the canvas tooling
needs, pac below what the Dataverse skills need — each causes errors that look
unrelated. Upgrade in place with the item's `update` command where it has one,
otherwise its install command.

**On managed devices, elevation is the wall.** Machine-wide repairs fail at UAC
with exit code **1602** for a standard user. Never leave them thinking that was
their mistake — route it to an IT request.

### Layer 2 — identity & auth (the pain centre)

This is where real users lose the most time. Surface it unprompted:

- **Who are you signed in as, everywhere?** pac auth profiles (active one
  highlighted) and the Azure CLI account. Present a **connection card**: user,
  tenant, environment, profile name.
- **Profile hygiene.** Multiple cached profiles from different customers are
  normal on consultant machines — and invisible until they bite. List them,
  offer to name unnamed ones per customer, delete stale ones, and select the
  right one for today.
- **Not signed in?** Work the **auth ladder**: device code first; interactive
  when Conditional Access blocks it (*"your sign-in was successful but does not
  meet the criteria to access this resource"*); if both fail, a policy-exemption
  request with the error code, correlation ID and timestamp from *More details*.
  **Never claim a browser window opened; you can't see their screen.**
- **Switching tenant? Say the whole cost upfront.** Auth lives in three places —
  the Azure CLI token, the pac profile, and any MCP tool-server process, which
  cached its token at startup and only refreshes on a **full host-app quit and
  relaunch**. Run the runbook in `${PLUGIN_ROOT}/shared/microsoft-refs.md`, and
  treat the switch as done only when a fresh environment list matches the
  *target* tenant.

### Layer 3 — agent runtimes

Which runtimes are installed and are they current? The Copilot desktop app
can't be detected from a terminal — ask.

### Layer 4 — plugins & marketplaces

Are the marketplaces registered and the plugins **loading**? Flag version drift
between runtimes — the same plugin at two versions behaves confusingly
differently. A plugin that installed but won't load usually means the agent
needs a restart, or a skill file is failing in one runtime only.

**Retired plugins.** Anything in the manifest's `retired` list that is still
installed is a finding: say what replaced it (`replacedBy`) and offer its
`action` — usually uninstall from every runtime — with consent, like any other
repair. A retired plugin left behind competes for triggers with its
replacement.

### Layer 5 — MCP wiring

Are the MCP servers the user relies on connected? Don't probe the Learn
endpoint with a plain fetch — a **405 means alive**. A server bundled by two
plugins and also registered by hand is duplication worth tidying.

**"The tools were there yesterday"** is usually scope, not breakage. A server
registered without a user scope belongs to the folder it was added in, so it
vanishes in every other project folder — and a session opened in a *parent*
folder doesn't see a project folder's servers either. Check where the session
is running, then re-register the server for the user (the manifest's commands
do) or rely on the plugin that bundles it. A server stuck *pending approval*
or needing sign-in shows as connected-but-toolless: approve it or sign in
through the runtime's MCP panel, then restart.

---

## The readiness card

Always finish with the readiness card **and the health report**. Generate the
report — read-only, scored the same way every time:

```
node ${PLUGIN_ROOT}/scripts/workstation-report.js --out-dir <working directory>
```

Quote its score and top fix in the chat, and give both paths
(`workstation-report.md`, `workstation-report.html`). Then the card:

> ## Machine readiness
>
> | Layer | Status |
> |---|---|
> | Tools | ✅ git · node 24 · .NET 10 · Python 3.12 · ⬆ pac 2.10 → upgrade |
> | Identity | ✅ user@contoso.com · Contoso Dev (profile "ContosoDev", 1 of 3) |
> | Agent runtimes | ✅ Copilot CLI 1.0.80 · ⚠️ Claude Code not installed |
> | Plugins | ✅ dataverse · power-automate (both runtimes) · ⚠️ drift: design 0.1.0 vs 0.2.0 |
> | MCP wiring | ✅ Learn (bundled) · ⚠️ pac MCP not registered |
>
> **Repaired this session:** upgraded pac, named 2 auth profiles, removed 1 stale profile.
> **Not installed (run setup-workstation to add):** Azure CLI.

Every ⚠️/❌ line carries its one-line fix. Offer the card as a rendered page
(`machine-readiness.html`) per `${PLUGIN_ROOT}/shared/artifact-style.md` —
useful as evidence for an IT request.

---

## Calibration

**"Check my setup"** → Full five-layer check-up, then the card.

**"Set up my new laptop" / "add canvas to my setup"** → That's setup-workstation. Hand over.

**"Which account am I signed in as?"** → Layer 2 only. Connection card, profile list, offer hygiene.

**"pac isn't working" / a tooling error pasted in** → Diagnose that layer first, repair, then offer the rest.

**Another skill found a broken tool** → Run the layers that matter for that build, report in card format.

reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall