Install Claude Code Skills & MCP

Install PSI Claude Code Skills & MCP Servers

One command to set up PSI-specific skills and MCP servers in Claude Code — no GitHub access required.

---

What This Installs

Piece	What it does
Skills	Give Claude PSI terminology, redbook workflows, machine types, LDS methodology, and more
MCP servers	Give Claude tools — live access to BOM, PLC, drawings, inventory, fleet data via the Machine Intelligence MCP Server on PS-PROXY

Skills uploaded to the Claude Enterprise admin console only reach Claude.ai web/desktop. For Claude Code (the CLI), both skills and MCP must be installed locally — this page is the one-command way to do it.

---

Quick Start

Make sure Claude Code is already installed (Developer Setup). Then run this in PowerShell:

iwr https://wiki.progressivesurface.com/assets/claude-skills/install-psi-skills.ps1 | iex

This does three things:

1. Installs the default skills (psi-context, cowork-best-practices) into ~/.claude/skills/
2. Adds the psi-machine MCP server to Claude Code (~/.claude.json)
3. Adds the psi-machine MCP server to Claude Desktop (AppData\Roaming\Claude\claude_desktop_config.json), if installed

Skills are picked up on your next message. MCP servers load when the app (re)starts — type /mcp in Claude Code to verify psi-machine shows as connected. Restart Claude Desktop to pick up the Desktop config.

---

Pick Specific Skills

List what’s available:

& ([scriptblock]::Create((iwr https://wiki.progressivesurface.com/assets/claude-skills/install-psi-skills.ps1).Content)) -List

Install a single skill:

& ([scriptblock]::Create((iwr https://wiki.progressivesurface.com/assets/claude-skills/install-psi-skills.ps1).Content)) -Skill quality-workflows

Install everything (all skills + all MCP servers):

& ([scriptblock]::Create((iwr https://wiki.progressivesurface.com/assets/claude-skills/install-psi-skills.ps1).Content)) -All

Skip the MCP step (skills only):

& ([scriptblock]::Create((iwr https://wiki.progressivesurface.com/assets/claude-skills/install-psi-skills.ps1).Content)) -SkipMcp

Configure MCP only (skip skills — useful if skills are already installed):

& ([scriptblock]::Create((iwr https://wiki.progressivesurface.com/assets/claude-skills/install-psi-skills.ps1).Content)) -McpOnly

Configure MCP for Claude Code only (skip Claude Desktop):

& ([scriptblock]::Create((iwr https://wiki.progressivesurface.com/assets/claude-skills/install-psi-skills.ps1).Content)) -McpOnly -SkipDesktop

---

Available MCP Servers

Server	What it adds	URL
psi-machine	64 tools across project/machine identity, BOM & supply chain, PLC & controls, engineering files, RFCs, diagnostics, inventory & cost, customers & sales, fleet intelligence, AI-powered PLC assessment	http://ps-proxy:3100/mcp

The installer merges these into both Claude Code and Claude Desktop configs without touching other MCP servers you already have configured. Re-run any time to update URLs.

Full tool reference: PSI Machine Intelligence MCP Server.

---

Available Skills

Skill	Audience	What It Adds
psi-context	All users	Company overview, terminology (Redbook, AFTEC, BOM, GTCode, PHYS., job numbers), LDS methodology, departments
cowork-best-practices	All users	How to get the most out of Cowork at PSI
quality-workflows	Quality team	Redbook/RFC process, ECN/NCN handling, quality metrics, SLAs
controls-engineering	Controls & Mech Eng	PLC conventions, BOM hierarchy, drawings, machine project structure
proposal-writing	Proposal team	Project types, machine specs, quoting context, SLDS
azure-devops	Developers	Work item fields, board queries, REST API patterns
fresh-eyes	Developers	Independent review perspective for code and decisions

The default install includes the “All users” skills only. Pick others with -Skill <name> if they fit your role.

---

Manual Install (No Script)

If you’d rather skip the script, you can grab any skill as a zip and extract it yourself:

1. Download the zip: https://wiki.progressivesurface.com/assets/claude-skills/psi-context.zip
2. Extract into ~/.claude/skills/ so you end up with ~/.claude/skills/psi-context/SKILL.md
3. Claude Code detects it on the next message

PowerShell equivalent:

$skill = 'psi-context'
$dst   = "$env:USERPROFILE\.claude\skills"
Invoke-WebRequest "https://wiki.progressivesurface.com/assets/claude-skills/$skill.zip" -OutFile "$env:TEMP\$skill.zip"
Remove-Item "$dst\$skill" -Recurse -Force -ErrorAction SilentlyContinue
Expand-Archive "$env:TEMP\$skill.zip" -DestinationPath $dst -Force

---

Verify It Worked

After install, check the folder exists:

Get-ChildItem "$env:USERPROFILE\.claude\skills"

You should see one folder per skill, each containing a SKILL.md. Then open Claude Code and try:

What does PHYS. mean at PSI?

Claude should explain the GTCode hierarchy. If it doesn’t, the skill isn’t loaded — see Troubleshooting.

---

Updating Skills

Re-run the installer any time — it replaces the skill folder cleanly:

iwr https://wiki.progressivesurface.com/assets/claude-skills/install-psi-skills.ps1 | iex

---

Troubleshooting

”Could not reach the wiki”

You’re off the PSI network or VPN. Connect and retry.

Claude doesn’t seem to use the skill

• Confirm ~/.claude/skills/<name>/SKILL.md exists and contains YAML frontmatter
• The skill’s description: in the frontmatter determines when Claude invokes it; if your question doesn’t match the description, Claude won’t load it
• Start a new session if the skill was just added to a brand-new ~/.claude/skills/ directory that didn’t exist before

/mcp says psi-machine failed to connect

• You’re off the PSI network/VPN. Connect and type /mcp again.
• Check the server is up: curl http://ps-proxy:3100/health should return JSON with "status":"ok".
• Restart Claude Code — MCP server config is read at startup, not on every message.
• Inspect the Claude Code config: (Get-Content $env:USERPROFILE\.claude.json | ConvertFrom-Json).mcpServers — look for the psi-machine entry.

Claude Desktop doesn’t show the MCP server

• Restart Claude Desktop — it reads the config only at launch.
• Inspect the config: Get-Content "$env:APPDATA\Claude\claude_desktop_config.json" — look for psi-machine.
• If the file is missing, Claude Desktop may not be installed, or re-run the installer after installing it.

”Execution policy” error

PowerShell is blocking scripts. Run this once per session:

Set-ExecutionPolicy -Scope Process Bypass

Then retry the install command.

I added a new skill and want to publish it

Source for every skill lives in psi-claude-org-skills. Add the skill folder, rebuild zips, copy them into this wiki under content/assets/claude-skills/, update manifest.json, and push v4.

---

Related Pages

• dev-setup — Full developer environment setup (installs Claude Code itself)
• connect-ai — Other AI integration options (web chat, Claude Desktop, MCP)
• claude-code — Claude Code reference for PSI

---

Last updated: April 2026