Menu
Workstation health triage — validate tooling, directory layout, and run dots-doctor with remediation suggestions.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Syncs knowledge to the ai-workspace knowledge base. Use when the assistant discovers new patterns, learns user preferences, or identifies information worth preserving for future sessions. Integrates with dots-workstation-tech-assistant for automatic trigger points.
Interact with Slack workspaces for reading channels/messages, sending messages, adding reactions, and browsing canvases. Use when the user asks about agentic-workstation Slack channels, messages, or notifications — NOT for Slack app development (use the slack-cli skill for that).
ClickUp CLI for managing tasks, sprints, comments, statuses, and Docs. Use when the user needs to interact with ClickUp — creating/editing tasks, checking sprint status, adding comments, linking PRs, managing Docs and pages, or searching tasks. Prefer this CLI over raw API calls.
WHAT — Generate or update documentation from code: README.md from repo structure, CHANGELOG.md from git history, API reference from OpenAPI/GraphQL schemas, and AGENTS.md starters for new projects.
Getting started guide for new agentic-workstation users. Walks through setup validation, the skill/agent hierarchy, and the three most useful commands per role (developer, PM, tech lead). Use when someone is new to the workstation or asks "where do I start?"
UI/UX design intelligence. 67 styles, 96 palettes, 57 font pairings, 25 charts, 13 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples.
| name | dots-workstation-triage |
| description | Workstation health triage — validate tooling, directory layout, and run dots-doctor with remediation suggestions. |
| metadata | {"author":"agentic-workstation","version":"1.1"} |
Use when the user reports workstation issues, install problems, tool failures, or needs a health check before starting work.
Run this skill on the local workstation where the user is experiencing issues. Do not run it on a remote server unless the user confirms the remote has the agentic-workstation setup.
Verify dots-doctor is installed:
command -v dots-doctor
If missing, install via chezmoi (chezmoi apply) or direct installation.
Use the mode that matches the user's need:
| Mode | Command | When to use |
|---|---|---|
| Colored (default) | dots-doctor | Interactive terminal session — human-readable colored output |
| Markdown | dots-doctor --issue | GitHub issues, Slack threads, tickets — paste-ready block |
| JSON | dots-doctor --json | Automation scripts, CI parsing — single-line machine-readable |
--issue)Always use dots-doctor --issue (not the default) when the output will be shared in:
--json)Use dots-doctor --json only when:
python3 in PATHThe doctor's behavior is controlled by ~/.config/agentic-workstation/profile.env. Checks can be selectively enabled/disabled via environment variables:
| Variable | Default | Effect |
|---|---|---|
DOTS_WORKSTATION_DOCTOR_GROUP_CORE | true | Core tools: git, curl, wget, jq, rg, fd, zsh, gh |
DOTS_WORKSTATION_DOCTOR_GROUP_NODE | true | Node.js: fnm, node |
DOTS_WORKSTATION_DOCTOR_GROUP_PYTHON | true | Python: uv, python3 |
DOTS_WORKSTATION_DOCTOR_GROUP_DOCKER | true | Docker: docker |
DOTS_WORKSTATION_DOCTOR_GROUP_AI | true | LLM API key presence flags (ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY) |
DOTS_WORKSTATION_DOCTOR_GROUP_SKILLS_PRODUCTIVITY | false | Optional productivity tool group |
DOTS_WORKSTATION_DOCTOR_SKILL_JIRA | false | JIRA skill integration check |
DOTS_WORKSTATION_DOCTOR_SKILL_CONFLUENCE | false | Confluence skill integration check |
Note: Profile variables are read from
~/.config/agentic-workstation/profile.env. If the file is missing, defaults apply.
The doctor validates the presence and structure of:
~/.local/share/agentic-workstation/prompts~/.local/share/agentic-workstation/skills~/.local/share/agentic-workstation/templates~/.local/share/agentic-workstation/mcp/github~/.local/share/agentic-workstation/mcp/clickup~/.local/share/agentic-workstation/mcp/notion~/.local/share/agentic-workstation/mcp/slackPropose fixes in order of lowest risk first:
chezmoi apply to bootstrap the full agentic-workstation installationuv via curl -LsSf https://astral.sh/uv/install.sh)gh auth login, clickup auth login, or glab auth login as appropriate~/.config/agentic-workstation/profile.env and run chezmoi applyRun with --issue to get the full markdown checklist. Address failures in this order:
chezmoi apply to restore directory structuregh, clickup, glab)~/.config/agentic-workstation/profile.env matches the intended profileIf python3 is not available, fall back to dots-doctor --issue and parse the markdown manually.
The easyoptions.sh library is missing from ~/.local/lib/agentic-workstation. Re-run chezmoi apply to restore it, or check if the agentic-workstation installation is incomplete.
profile.env or authentication state — user must approve and execute fixes.dots-workstation-dev-companion or direct chezmoi guidance.dots-workstation-build-error-resolver instead of this skill.dots-doctor --help — full option list~/.config/agentic-workstation/profile.env — check group configuration~/.local/lib/agentic-workstation/easy-options/easyoptions.sh — dependency library