Skill

angreal-usage

Guides discovering, running, chaining, and interpreting Angreal CLI tasks via commands like `angreal tree` and `angreal test all`. Covers workflows for testing, building, deploying.

Bash

cli-tools

automation

Install

npx claudepluginhub angreal/angreal --plugin angreal

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Learn to discover, run, and chain angreal tasks effectively.

SKILL.md

Similar Skills

using-git-worktrees

Creates isolated Git worktrees for feature branches with prioritized directory selection, gitignore safety checks, auto project setup for Node/Python/Rust/Go, and baseline verification.

superpowers

168.3k

subagent-driven-development

3 files

Executes implementation plans in current session by dispatching fresh subagents per independent task, with two-stage reviews: spec compliance then code quality.

superpowers

168.3k

dispatching-parallel-agents

Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.

superpowers

168.3k

Stats

Parent Repo Stars11

Parent Repo Forks5

Last CommitJan 12, 2026

Actions

View Source View Plugin View on GitHub View README

Using Angreal Tasks

Learn to discover, run, and chain angreal tasks effectively.

Prerequisites

Working within an angreal project (has .angreal/ directory)
angreal CLI installed and available

Discovering Tasks

Quick Discovery

angreal tree

Shows all commands with arguments and short descriptions:

dev: development utilities
  check-deps - Verify required development tools are installed
test: commands for testing the application
  all - Run complete test suite
  rust [--unit-only] - Run Rust tests
docs: commands for documentation
  build [--draft] - Build documentation site

Detailed Discovery (AI Guidance)

angreal tree --long

Includes full ToolDescription prose for each command:

When to use - Appropriate scenarios
When NOT to use - Situations to avoid
Examples - Concrete invocations
Risk level - safe, read_only, or destructive

Traditional Help

angreal --help              # List all commands
angreal test rust --help    # Help for specific command

Running Tasks

Basic Invocation

angreal <group> <command> [arguments]

# Examples
angreal test all
angreal test rust --unit-only
angreal build --release
angreal docs serve --prod

Arguments

Flags (boolean switches):

angreal build --release
angreal test rust --unit-only

Value arguments:

angreal deploy --version v1.2.3
angreal test completion --shell=bash

Output and Exit Codes

Exit code 0 = success
Non-zero exit code = failure

angreal test all && angreal deploy  # Chain with &&

Common Workflows

Before Committing

angreal test unit      # Fast unit tests first
angreal test all       # Full suite if units pass
angreal lint check     # Check code style

Release Process

angreal test all           # Ensure tests pass
angreal build --release    # Create release build
angreal docs build         # Update documentation
angreal deploy staging     # Deploy to staging

Debugging

angreal test <specific-test> --verbose  # Verbose output
# Check stdout/stderr for error details
# Fix issue, re-run specific test
angreal test all                        # Verify no regressions

Task Groups

Tasks are organized by function:

Group	Purpose
`dev`	Development utilities
`test`	Testing commands
`docs`	Documentation
`build`	Build and compilation
`deploy`	Deployment and release

Groups can nest: angreal docker compose up

Choosing the Right Task

Run angreal tree to see available commands
Use angreal tree --long for detailed guidance
Start with read-only tasks to explore safely
Trust ToolDescriptions - they're written to guide you