alps
Create, validate, and improve ALPS profiles. Generate from natural language descriptions, validate existing profiles, and get improvement suggestions.
npx skills add majiayu000/claude-skill-registry --skill alps --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# ALPS Profile Assistant Generate, validate, and improve ALPS profiles for RESTful API design. ## Ideal ALPS Profile **Goal: An ALPS that someone unfamiliar with the app can read and understand.** ### What Makes a Good ALPS 1. **States = What the user sees** - `ProductList` - viewing a list of products - `ProductDetail` - viewing one product - `Cart` - viewing cart contents 2. **Transitions = What the user does** - `goProductDetail` - select a product - `doAddToCart` - add to cart 3. **Self-documenting** - `title` explains the purpose - `doc` describes behavior and side effects - No need to read code to understand 4. **No unreachable states** - Every state has an entry point - Orphan states indicate design mistakes 5. **Necessary and sufficient** - No over-abstraction - Describes semantics, not implementation - No HTTP methods or URLs ### What to Avoid - Mechanical CRUD listings without meaning - Implementation details leaking in - States without transitions (can't draw a diagram) - Excessive documentation nobody reads ## How to Use This skill responds to natural language requests: ### Generate ALPS from Natural Language - "Create an ALPS profile for a blog application" - "Generate
- Ideal ALPS Profile
- What Makes a Good ALPS
- What to Avoid
- How to Use
- Generate ALPS from Natural Language
- Validate Existing Profile
- Get Improvement Suggestions
- ALPS Structure Reference
- Three Layers of ALPS
- Naming Conventions
- Safe Transition Naming Rule
- Determining idempotent: PUT vs DELETE
- Generation Guidelines
- When Creating ALPS from Natural Language
Generate HTML diagram asd profile.json Generate with watch mode asd --watch profile.json Generate markdown documentation asd --mode=markdown profile.json
What does the alps skill do?
Create, validate, and improve ALPS profiles. Generate from natural language descriptions, validate existing profiles, and get improvement suggestions.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill alps --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.