# Way Magefile

> Build tool for Go projects. Use when the user wants to create, edit, or understand Way-specific Magefiles, build targets, or automate Go project tasks.

- **Type:** Skill
- **Install:** `agentstack add skill-way-platform-skills-way-magefile`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [way-platform](https://agentstack.voostack.com/s/way-platform)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [way-platform](https://github.com/way-platform)
- **Source:** https://github.com/way-platform/skills/tree/main/way-magefile

## Install

```sh
agentstack add skill-way-platform-skills-way-magefile
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Mage

Mage is a make-like build tool using Go. You write plain-old go functions, and Mage automatically uses them as Makefile-like runnable targets.

## When to Use

- Creating build scripts for Go projects.
- Automating tasks (install, build, clean, release).
- Managing dependencies between tasks.

## Core Concepts

### 1. Magefiles

- Any Go file with `//go:build mage` (or `+build mage` for older Go).
- Usually named `magefile.go` or placed in `magefiles/` directory.
- `package main`.

### 2. Targets

- Exported functions with specific signatures:
- `func Target()`
- `func Target() error`
- `func Target(ctx context.Context) error`
- First sentence of doc comment is the short description (`mage -l`).

### 3. Dependencies

- Use `mg.Deps(Func)` to declare dependencies.
- Dependencies run exactly once per execution.
- `mg.Deps` runs in parallel; `mg.SerialDeps` runs serially.

## Quick Start

To create a new magefile:
`mage -init`

## Common Tasks

**Running Commands:**
Use `github.com/magefile/mage/sh` for shell execution.

```go
import "github.com/magefile/mage/sh"
// ...
err := sh.Run("go", "build", "./...")
```

**Clean Up:**

```go
import "github.com/magefile/mage/sh"
// ...
sh.Rm("bin")
```

## References

- **Way Conventions**: See [references/way-style.md](references/way-style.md) for Way-specific patterns and helpers.
- **API Documentation**: See [references/api.md](references/api.md) for `mg`, `sh`, and `target` package details.
- **Examples**: See [references/examples.md](references/examples.md) for common patterns.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [way-platform](https://github.com/way-platform)
- **Source:** [way-platform/skills](https://github.com/way-platform/skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-way-platform-skills-way-magefile
- Seller: https://agentstack.voostack.com/s/way-platform
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.