harness-skills

# Harness Skills

Claude Code skills for the [Harness.io](https://harness.io) CI/CD platform. Generate pipeline YAML, manage resources, debug failures, analyze costs, and more from natural language.

This repository is designed as a workflow system, not just a folder of prompts. The top-level instructions (`CLAUDE.md`, `AGENTS.md`, `.github/cursor-instructions.md`) establish shared behavior, while individual skills specialize in creation, debugging, governance, and reporting tasks.

## Prerequisites

- [Harness MCP v2 Server](https://github.com/harness/mcp-server) - required for MCP-powered skills. Most skills in this repo depend on it for Harness API access.

## Setup

### Claude Code

Clone the repo and run Claude Code from the project directory. Skills are automatically discovered from `CLAUDE.md` and `skills/*/SKILL.md`:

```bash
git clone https://github.com/harness/harness-skills.git
cd harness-skills
cursor
```

To add the Harness MCP server, configure it in your Claude Code settings (`~/.cursor/settings.json`):

```json
{
  "mcpServers": {
    "harness-mcp-v2": {
      "command": "npx",
      "args": ["-y", "harness-mcp-v2"],
      "env": {
        "HARNESS_API_KEY": "<your-api-key>"
      }
    }
  }
}
```

Invoke skills by name:

```
/create-pipeline
Create a CI pipeline for a Node.js app that builds, runs tests,
and pushes a Docker image to ECR
```

### Cursor

1. Clone the repo into your project or as a reference workspace:

```bash
git clone https://github.com/harness/harness-skills.git
```

2. The repo includes `.cursor/rules/harness.mdc`, which Cursor automatically loads as a project rule.

3. Configure the Harness MCP server in Cursor (`~/.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "harness-mcp-v2": {
      "command": "npx",
      "args": ["-y", "harness-mcp-v2"],
      "env": {
        "HARNESS_API_KEY": "<your-api-key>"
      }
    }
  }
}
```

4. Reference individual skills in your prompts using `@file`:

```
@harness-skills/skills/create