skills.rest
semicolon-devteam
semicolon-devteamOFFICIAL
Explore all skills by this author →
WebsiteGitHub

semo-architecture-checker

Validate and auto-correct the SEMO .claude directory structure and symlinks.

Updated Dec 11, 2025
Search Tags:#automation#health check#architecture validation#directory management#integrity check#symlinks#SEMO
One-click install
npx skills add https://github.com/semicolon-devteam/semo --skill semo-architecture-checker
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: semo-architecture-checker
Source: https://github.com/semicolon-devteam/semo/tree/main/semo-skills/semo-architecture-checker
Command: npx skills add https://github.com/semicolon-devteam/semo --skill semo-architecture-checker

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Bash, and includes references (resource) components.

What problem does it solve?

This Skill automatically detects and fixes structural inconsistencies, broken symlinks, and missing components within the .claude directory, ensuring the SEMO environment remains healthy and functional, especially after updates.

Core Features & Use Cases

  • Structure Validation: Verifies the integrity of the .claude directory, including package presence and symlink validity.
  • Automatic Correction: Automatically repairs broken or missing symlinks for agents, skills, and commands.
  • Update Integrity: Ensures that SEMO updates correctly integrate new components and maintain existing links.
  • Check-Only Mode: Allows for non-destructive validation to identify issues without applying fixes.
  • Use Case: After a SEMO update, this skill can automatically run to confirm everything is correctly linked and configured, or you can manually trigger it with "/SEMO:health" to diagnose any suspected issues.

Quick Start

Check SEMO health: "/SEMO:health" Verify .claude directory: ".claude 확인" Fix broken symlinks: "심링크 확인"

Frequently Asked Questions about semo-architecture-checker

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

FAQPage Schema
How do I check if my SEMO directory structure is intact after an update?▼

Run `/SEMO:health` to validate your `.claude` directory integrity, detect broken symlinks, and identify missing components. The Skill produces a parseable health report showing what needs repair.

Can I automatically fix broken symlinks in my SEMO environment?▼

Yes. The architecture checker auto-corrects broken symlinks for agents, skills, and commands, regenerates CLAUDE.md links, and repairs merged directories. It runs during updates or when manually triggered.

What happens to my SEMO setup during version updates?▼

The Skill ensures SEMO updates correctly integrate new components and maintain existing links by validating the `.claude` directory structure and automatically repairing any inconsistencies introduced during the update process.

Can I validate my SEMO directory without making changes?▼

Yes. Check-only mode allows non-destructive validation to identify structural issues, broken symlinks, and missing components without applying automatic fixes.

When should I manually run a SEMO health check?▼

Manually trigger a health check after suspected broken symlinks, when components appear missing, or when agents and skills aren't loading correctly. Use `/SEMO:health` or `.claude 확인` to diagnose issues.

Related Skills

Explore More Software Engineering Skills→
BordaBorda
24

init

Merge settings and create symlinks for Foundry plugin post-install configuration.

Community
Advanced
metric-space-aimetric-space-ai
2

self-improving-review

Record validated skill mutations with evidence in the improvement ledger and notify owner on success.

Official
Advanced
agentteamlandagentteamland

team

Manage AgentTeamLand team installation, updates, removal, and listing in .claude directories.

Official
Advanced
aget-frameworkaget-framework

aget-check-health

Inspect AGET agent directory structures and configuration files for health.

Official
Basic