asd-cli

Validate ALPS profiles and convert them to DOT format for Graphviz diagrams.

Updated Dec 12, 2025
One-click install
npx skills add https://github.com/hajime-matsumoto/app-state-diagram-cli --skill asd-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: asd-cli
Source: https://github.com/hajime-matsumoto/app-state-diagram-cli/tree/main/.
Command: npx skills add https://github.com/hajime-matsumoto/app-state-diagram-cli --skill asd-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers and teams quickly validate, visualize, and integrate ALPS profiles using a single CLI, removing manual steps and enabling faster iteration.

Core Features & Use Cases

  • Validation: Validate ALPS profiles with asd-cli validate to ensure syntax, structure, and semantics.
  • Visualization: Convert ALPS to DOT format with asd-cli alps2dot for Graphviz diagrams.
  • MCP Integration: Start an MCP server for Claude Desktop integration and workflow automation.

Quick Start

Run the following to validate a profile.json and generate a diagram: asd-cli validate profile.json asd-cli alps2dot profile.json | dot -Tsvg > diagram.svg

Frequently Asked Questions about asd-cli

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

FAQPage Schema
How do I validate ALPS profiles for structural correctness?

Validate ALPS profiles using `asd-cli validate profile.json` to check syntax, structure, and semantic conformance. This ensures your profile meets ALPS standards before deployment or integration.

Can I convert ALPS profiles to Graphviz diagrams?

Yes. Use `asd-cli alps2dot profile.json | dot -Tsvg > diagram.svg` to convert ALPS to DOT format and generate visual diagrams. This helps document and review profile architecture.

What is ALPS and why validate it?

ALPS (Application Level Profile Semantics) is a lightweight specification format for describing API semantics. Validation ensures profiles are syntactically correct and follow ALPS conventions, preventing integration errors.

How do I integrate ALPS workflows with Claude Desktop?

Start an MCP server using asd-cli's built-in MCP integration to connect ALPS validation and visualization directly to Claude Desktop, automating profile management and enabling conversational workflows.

Does asd-cli work as a standalone CLI or require additional setup?

asd-cli operates as a single CLI tool for validation, conversion, and MCP server tasks without external dependencies. No additional configuration is required for core validation and visualization features.

What file formats does asd-cli support?

asd-cli accepts ALPS profiles (typically JSON) as input and outputs DOT format for Graphviz. It integrates with MCP for extended workflow automation and Claude Desktop connectivity.