Back to Skills

mise-task-configuration

verified

Use when defining and configuring Mise tasks in mise.toml. Covers task definitions, dependencies, file tasks, and parallel execution.

View on GitHub

Marketplace

han

TheBushidoCollective/han

Plugin

jutsu-mise

Technique

Repository

TheBushidoCollective/han
60stars

jutsu/jutsu-mise/skills/task-configuration/SKILL.md

Last Verified

January 24, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/TheBushidoCollective/han/blob/main/jutsu/jutsu-mise/skills/task-configuration/SKILL.md -a claude-code --skill mise-task-configuration

Installation paths:

Claude
.claude/skills/mise-task-configuration/
Powered by add-skill CLI

Instructions

# Mise - Task Configuration

Defining and managing tasks in Mise for build automation, testing, and development workflows.

## Basic Task Definition

### Simple TOML Tasks

```toml
# mise.toml
[tasks.build]
description = "Build the project"
run = "cargo build --release"

[tasks.test]
description = "Run all tests"
run = "cargo test"

[tasks.lint]
description = "Run linter"
run = "cargo clippy -- -D warnings"
```

### Running Tasks

```bash
# Run a task
mise run build
mise build  # Shorthand if no command conflicts

# Run multiple tasks
mise run build test lint

# List available tasks
mise tasks ls

# Show task details
mise tasks info build
```

## Task Dependencies

### Sequential Dependencies

```toml
[tasks.deploy]
description = "Deploy the application"
depends = ["build", "test"]
run = "./deploy.sh"
```

### Parallel Dependencies

```toml
[tasks.ci]
description = "Run CI checks"
depends = ["lint", "test", "security-scan"]
run = "echo 'All checks passed'"
```

Mise automatically runs dependencies in parallel when possible.

## File Tasks

### Creating File Tasks

```bash
# Create task directory
mkdir -p .mise/tasks

# Create executable task file
cat > .mise/tasks/deploy <<'EOF'
#!/usr/bin/env bash
# mise description="Deploy the application"
# mise depends=["build", "test"]

echo "Deploying..."
./scripts/deploy.sh
EOF

chmod +x .mise/tasks/deploy
```

### File Task Metadata

```bash
#!/usr/bin/env bash
# mise description="Task description"
# mise depends=["dependency1", "dependency2"]
# mise sources=["src/**/*.rs"]
# mise outputs=["target/release/app"]

# Task implementation
```

## Advanced Task Configuration

### Task Arguments

```toml
[tasks.test]
description = "Run tests with optional filter"
run = '''
if [ -n "$1" ]; then
  cargo test "$1"
else
  cargo test
fi
'''
```

```bash
# Run all tests
mise test

# Run specific test
mise test user_tests
```

### Environment Variables in Tasks

```toml
[tasks.build]
description = "Build with specific configuration"
env =

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
7478 chars

Issues Found:

  • name_directory_mismatch