likec4-architecture
Build and maintain software architecture as code with LikeC4 DSL. Use when tasks mention architecture diagrams, C4/context/container/component views, system landscape, dependency/integration maps, or when the user wants architecture generated/evolved from code. Apply for creating new `.c4`/`.likec4` models, updating existing models, validating with LikeC4 CLI, and preparing preview/build/export outputs.
How do I install this agent skill?
npx skills add https://github.com/timseriakov/likec4-architecture-skill --skill likec4-architectureIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides tools for LikeC4 architecture modeling, including template bootstrapping, CLI validation, and export capabilities. It relies on the official 'likec4' NPM package and follows standard software architecture practices. No security threats were identified.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
4/11 files flagged
What does this agent skill do?
LikeC4 Architecture
Model software architecture in LikeC4, keep it executable, and return validation-backed outputs.
Workflow
- Scope the model:
- Identify system boundary and audience.
- Start with context and container views unless user asks otherwise.
- Locate model files:
- Reuse existing
.c4/.likec4files when present. - If missing, bootstrap from
assets/likec4-starter/docs/architecture/model.c4.
- Model structure before visuals:
- Define stable element IDs and meaningful names.
- Add explicit directional relationships with short labels.
- Add technology/description fields where helpful.
- Keep views focused:
- Build small, purposeful views.
- Split crowded diagrams by domain, team, or bounded context.
- Validate and package:
- Run
npx likec4 validateand fix all errors. - Provide
npx likec4 startpreview command. - If requested, provide
build/exportcommands.
Required Quality Gates
- Do not leave unlabeled ambiguous relationships.
- Do not leave orphan elements that never appear in views.
- Prefer domain names over implementation noise in element titles.
- Finish only after successful CLI validation.
Command Set
Use the minimal commands needed for the task:
npx likec4 validate
npx likec4 start
npx likec4 build -o ./dist
npx likec4 export png -o ./assets/architecture
Output Contract
When architecture files change, return:
- Changed files.
- Validation result.
- One-line purpose for each view.
- Preview/build/export command(s) relevant to the request.
Resources
- CLI and modeling checklist:
references/likec4-checklist.md - Starter model template:
assets/likec4-starter/docs/architecture/model.c4 - Bootstrap helper:
scripts/bootstrap_likec4_starter.sh
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/timseriakov/likec4-architecture-skill/likec4-architecture">View likec4-architecture on skillZs</a>