health-check

Checks design-environment readiness for SEMO-Design by validating installed tools and producing a structured report.

Updated Dec 11, 2025
One-click install
npx skills add https://github.com/semicolon-devteam/semo --skill health-check-semicolon-devteam
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: health-check
Source: https://github.com/semicolon-devteam/semo/tree/main/packages/pm/skills/health-check
Command: npx skills add https://github.com/semicolon-devteam/semo --skill health-check-semicolon-devteam

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill requires Bash, gh, git, node, jq, and includes references (resource) components.

What problem does it solve?

This Skill automatically verifies a PM's development environment and GitHub permissions, ensuring they have all necessary tools and access to effectively use SEMO for project management tasks.

Core Features & Use Cases

  • Tool Verification: Checks for the presence and version of essential tools like GitHub CLI, Git, and Node.js.
  • GitHub Authentication & Permissions: Validates GitHub login status, required 'project' scope, and Organization membership.
  • SEMO Metadata Check: Confirms the existence and correctness of SEMO-specific metadata in ~/.claude.json.
  • Package Installation Status: Verifies that semo-core and semo-pm packages are correctly installed and symlinked.
  • Use Case: As a new PM, you can run "/SEMO:health-check" to quickly confirm your setup is ready for SEMO, or periodically check your environment to prevent permission-related issues.

Quick Start

Check PM environment: "/SEMO:health-check" Verify GitHub Projects access: "GitHub Projects ๊ถŒํ•œ ํ™•์ธ" Check SEMO installation: "SEMO ์„ค์น˜ ํ™•์ธ"

Frequently Asked Questions about health-check

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify my GitHub CLI and Git installation for project management?โ–ผ

GitHub CLI and Git verification checks that both tools are installed with correct versions and that you're authenticated to GitHub. Run the health-check to confirm these prerequisites are met before starting SEMO project management tasks.

What does it mean to validate GitHub Projects permissions and organization membership?โ–ผ

Permission validation ensures your GitHub account has the 'project' scope and active organization membership required to access and manage GitHub Projects. The health-check confirms you have the necessary GitHub authentication and access levels.

How do I check if SEMO packages and metadata are correctly installed?โ–ผ

Package verification checks that semo-core and semo-pm are installed, properly symlinked, and that SEMO metadata exists in ~/.claude.json with correct configuration. The health-check confirms your SEMO environment is ready for PM workflows.

Can I validate my PM environment setup without manually checking each tool?โ–ผ

Yes, the health-check automates validation of all essential tools, GitHub authentication, SEMO packages, and MCP server configurations in a single structured readiness report, eliminating manual per-tool checks.

What should I do if the health-check reports missing tools or failed permissions?โ–ผ

The health-check identifies which tools need installation, which GitHub permissions are missing, or which SEMO packages require setup. Address each reported gap before proceeding with SEMO project management.

When should I run a health-check during onboarding or environment changes?โ–ผ

Run health-check during new designer onboarding, orchestrator startup, before accessing external services, or after environment changes to ensure all dependencies and permissions are correctly configured for SEMO.