> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/harness-platform/use-harness-ai/harness-ai/govern-ai-output/workflow-and-references.md).

# Workflows and reference

[Skills](/harness-platform/use-harness-ai/harness-ai/govern-ai-output.md) chain together for multi-step workflows, and each skill file follows a consistent internal structure. This page covers common workflow sequences and the reference material for authoring or extending skills.

***

### What you will learn in this topic <a href="#what-you-will-learn-in-this-topic" id="what-you-will-learn-in-this-topic"></a>

By the end of this topic, you will be able to:

* [Chain skills together](#end-to-end-workflows) for multi-step workflows.
* [Understand skill anatomy](#skill-anatomy) to read or author a skill.
* [Reference the MCP tools](#mcp-tools) skills use to call the Harness platform.
* [Navigate the repository layout](#project-structure) for skills, references, and examples.

***

### Before you begin <a href="#before-you-begin" id="before-you-begin"></a>

Before you chain skills into a workflow, ensure you have the following:

* **Configured skills**: An AI coding assistant set up to load skill instructions. For more information, see [Set up skills](/harness-platform/use-harness-ai/harness-ai/govern-ai-output.md#set-up-skills).
* **Harness MCP Server**: A configured [MCP server](/harness-platform/use-harness-ai/harness-ai/connect-with-ai/harness-mcp-server.md) for tool execution.
* **Skill catalog familiarity**: Knowledge of which skills cover the resources in your workflow. For more information, see [Skill catalog](/harness-platform/use-harness-ai/harness-ai/govern-ai-output/harness-skills.md).

***

### End-to-end workflows <a href="#end-to-end-workflows" id="end-to-end-workflows"></a>

Most real tasks span several skills rather than one. Resources that depend on other resources must be created in the correct order, so the sequences below invoke skills in an order that satisfies those dependencies.

#### New microservice setup <a href="#new-microservice-setup" id="new-microservice-setup"></a>

Start with the resources that nothing else depends on, then work up to the pipeline and trigger that reference them.

Use these skills in order:

1. `/create-connector`: Git, Docker registry, and Kubernetes cluster connectors.
2. `/create-secret`: Credentials for connector authentication.
3. `/create-service`: Service definition referencing connectors.
4. `/create-environment`: Target environment configuration.
5. `/create-infrastructure`: Infrastructure definition for the target cluster.
6. `/create-pipeline`: CI/CD pipeline referencing the service, environment, and infrastructure.
7. `/create-trigger`: Webhook or schedule trigger to automate the pipeline.

#### Debug a failed deployment <a href="#debug-a-failed-deployment" id="debug-a-failed-deployment"></a>

Start debugging the failed execution, and then widen the investigation to the shared templates and delegates the pipeline depends on.

Typical sequence:

1. `/run-pipeline`: Identify the latest execution or reproduce the issue.
2. `/debug-pipeline`: Classify the failure and inspect the root cause.
3. `/template-usage`: Check if shared templates propagated the issue.
4. `/manage-delegates`: Investigate delegate capacity or connectivity if relevant.

#### Codebase-aware pipeline generation <a href="#codebase-aware-pipeline-generation" id="codebase-aware-pipeline-generation"></a>

Some skills read your repository directly, so they infer context from your code in addition to the detail you supply in the prompt.

The `/create-pipeline` skill includes codebase analysis capabilities. It scans your project files to auto-detect:

* **Language and runtime** from source files (`package.json` maps to Node.js, `go.mod` maps to Go).
* **Build tools** from build configuration (`Dockerfile`, `webpack.config.js`, `pom.xml`).
* **Test frameworks** from test configuration (`jest.config.*`, `pytest.ini`).
* **Deployment targets** from manifests (`Chart.yaml` maps to Helm, `task-definition.json` maps to ECS).

This allows the skill to generate pipeline YAML tailored to your project without manual configuration.

***

### Skill anatomy <a href="#skill-anatomy" id="skill-anatomy"></a>

Each skill lives in `skills/<skill-name>/SKILL.md` and follows a consistent structure. Knowing this structure helps you read existing skills and author your own.

```
skills/create-pipeline/
├── SKILL.md              # Skill definition (required)
└── references/           # Supplementary docs (optional)
    ├── native-steps.md
    ├── v0-pipeline-schema.md
    └── codebase-analysis.md
```

The `SKILL.md` file contains:

* **Frontmatter**: Name, description, version, MCP server dependency, and license metadata.
* **Instructions**: Phase-based steps with MCP tool calls and parameters.
* **Examples**: Real invocation scenarios and worked examples.
* **Performance notes**: Validation checks, tradeoffs, and optimization guidance.
* **Troubleshooting**: Common errors and recovery steps.

Reference files in the `references/` subdirectory provide supplementary knowledge, such as schema definitions, decision trees, and template libraries, that the AI loads on demand.

***

### MCP tools <a href="#mcp-tools" id="mcp-tools"></a>

Skills use the [Harness MCP Server](/harness-platform/use-harness-ai/harness-ai/connect-with-ai/harness-mcp-server.md), which provides 11 generic tools dispatched by `resource_type`.

| Tool               | Purpose                        |
| ------------------ | ------------------------------ |
| `harness_list`     | List resources.                |
| `harness_get`      | Get resource details.          |
| `harness_create`   | Create a resource.             |
| `harness_update`   | Update a resource.             |
| `harness_delete`   | Delete a resource.             |
| `harness_execute`  | Execute an action.             |
| `harness_search`   | Search across resources.       |
| `harness_describe` | Get resource schema.           |
| `harness_schema`   | Fetch JSON Schema definitions. |
| `harness_diagnose` | Diagnose issues.               |
| `harness_status`   | Check system status.           |

***

### Project structure <a href="#project-structure" id="project-structure"></a>

The repository groups skills, shared references, and examples into a predictable layout.

```
harness-skills/
├── skills/
│   ├── create-pipeline/
│   │   ├── SKILL.md
│   │   └── references/
│   ├── create-template/
│   │   └── SKILL.md
│   ├── debug-pipeline/
│   │   └── SKILL.md
│   └── ...
├── references/              # Shared repo-level playbooks
├── templates/               # Shared repo-level output templates
├── examples/
│   ├── v0/                  # v0 pipeline examples
│   ├── v1/                  # v1 pipeline examples
│   ├── templates/
│   ├── triggers/
│   ├── services/
│   ├── environments/
│   ├── connectors/
│   └── ...
├── .cursor/rules/harness.mdc
├── .github/copilot-instructions.md
├── AGENTS.md
├── CLAUDE.md
└── CONTRIBUTING.md
```

***

### Related articles <a href="#related-articles" id="related-articles"></a>

* [Harness Skills repository](https://github.com/harness/harness-skills): Browse the full skill source code and contribute new skills.
* [Harness MCP Server](/harness-platform/use-harness-ai/harness-ai/connect-with-ai/harness-mcp-server.md): Configure the MCP server that skills use to execute actions against Harness.
* [Contributing guide](https://github.com/harness/harness-skills/blob/main/CONTRIBUTING.md): Learn the conventions for submitting a new skill to the repository.
* [Harness Skills overview](/harness-platform/use-harness-ai/harness-ai/govern-ai-output.md): Prerequisites and editor setup.