likec4-dsl

Generate and validate LikeC4 DSL architecture definitions for .c4 and .likec4 files.

4|2|Updated May 18, 2022
One-click install
npx skills add https://github.com/pjmagee/starwars-data --skill likec4-dsl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: likec4-dsl
Source: https://github.com/pjmagee/starwars-data/tree/main/.agents/skills/likec4-dsl
Command: npx skills add https://github.com/pjmagee/starwars-data --skill likec4-dsl

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Provide authoritative syntax, workflow guidance, and validation rules for writing, editing, and maintaining LikeC4 DSL files so architects and engineers can produce consistent, project-scoped architecture-as-code and diagrams without manual format errors or merging mistakes.

Core Features & Use Cases

  • Specification and Modeling Rules: Precise guidance for top-level blocks, element kinds, relationship kinds, tags, and style properties to ensure correct model structure.
  • Multi-file Project Workflows: Explains project scoping, config discovery, multi-file merging semantics, FQN usage, and extension patterns for scalable architecture projects.
  • Validation and Tooling: Describes CLI validation, export, codegen, serve, and MCP integration to validate edits, export diagrams, and generate artifacts for CI or local preview.
  • Use Case: Create a shared specification file, split model and views across files, run validation to find FQN and merge errors, then export diagrams for documentation.

Quick Start

Open or create a .c4 or .likec4 file in the project folder containing a project config and ask the assistant to generate and validate a specification, model, and view for your architecture.

Frequently Asked Questions about likec4-dsl

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

FAQPage Schema
How do I validate LikeC4 DSL files for architecture-as-code errors?

Validate LikeC4 DSL files by running npx likec4 validate with CLI v1.53 or higher to enforce top-level block merging, identifier rules, and FQN semantics across multi-file projects.

What is the best way to split a LikeC4 model across multiple files?

Split LikeC4 models across multiple files using project scoping and config discovery, applying FQN usage and top-level block merging semantics to maintain a consistent architecture-as-code structure.

How do I generate LikeC4 diagrams from .c4 specification files?

Generate LikeC4 diagrams from .c4 files by authoring specifications, models, and views, then using CLI export commands to produce diagram artifacts for documentation or local preview.

Does the LikeC4 DSL support Markdown-friendly properties in model definitions?

LikeC4 DSL supports Markdown-friendly properties within model definitions, allowing you to style elements, define relationship kinds, and apply tags while maintaining correct specification structure.

Why does multi-file LikeC4 project merging fail with FQN errors?

Multi-file LikeC4 merging fails when fully qualified name rules are violated, requiring CLI validation to identify incorrect top-level block merging or identifier conflicts across project files.

Can I use LikeC4 for code generation and CI integration?

LikeC4 supports code generation and CI integration through CLI codegen commands, enabling automated export of architecture diagrams and code artifacts from validated .c4 and .likec4 files.