Skip to content
Back to search

harness-skills

SkillGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 13 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/harness/harness-skills with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/harness/harness-skills'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/harness--harness-skills/badge.svg)](/listings/harness--harness-skills)

HTML

<a href="/listings/harness--harness-skills"><img src="/api/listings/harness--harness-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Each category is its own plugin. On Claude Code 2.1.275 or later, install one in a single step (swap `harness-fme` for any plugin in the tables above; each table shows its own install line):

/plugin install harness-fme --marketplace harness/harness-skills

On older versions, add the marketplace first, then install:

/plugin marketplace add harness/harness-skills
/plugin install harness-fme@harness-skills

The same from a shell:

claude plugin install harness-fme --marketplace harness/harness-skills

# older versions: add the marketplace first
claude plugin marketplace add harness/harness-skills
claude plugin install harness-fme@harness-skills

Invoke an installed skill as `/<plugin>:<skill>`:

/harness-fme:explain-flag
Explain the new_checkout flag in production

To update, run `/plugin marketplace update harness-skills`. Plugins are versioned by git commit. Each installed plugin caches a full copy of this repository (about 8 MB), because skills link to the shared `references/` and `templates/` at the repo root. Installing all nine plugins stores nine copies.

**Known gap:** plugin installs do not load the repo-level `AGENTS.md` rules (scope establishment, dependency checks, schema validation). FME skills load their shared rules through `references/fme/`; other skills rely on their own instructions. To get the repo-level rules, work from a clone (see [Quick Start without a plugin](#quick-start-without-a-plugin)).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 238 lines
  1. {
  2. "name": "harness-skills",
  3. "owner": {
  4. "name": "Harness"
  5. },
  6. "metadata": {
  7. "description": "74 Harness skills for AI coding agents, as 10 domain plugins."
  8. },
  9. "plugins": [
  10. {
  11. "name": "harness-pipelines",
  12. "displayName": "Harness Pipelines & Execution",
  13. "description": "9 skills: Create v0 and v1 pipelines, triggers, templates and freeze windows, then run, debug and migrate them.",
  14. "source": ".",
  15. "strict": false,
  16. "skills": [
  17. "./skills/pipelines"
  18. ],
  19. "category": "ci-cd",
  20. "keywords": [
  21. "harness",
  22. "pipelines",
  23. "ci-cd",
  24. "triggers",
  25. "templates"
  26. ],
  27. "author": {
  28. "name": "Harness"
  29. },
  30. "repository": "https://github.com/harness/harness-skills",
  31. "license": "Apache-2.0"
  32. },
  33. {
  34. "name": "harness-infrastructure",
  35. "displayName": "Harness Infrastructure & Resources",
  36. "description": "5 skills: Define services, environments, infrastructure, connectors and secrets for Harness deployments.",
  37. "source": ".",
  38. "strict": false,
  39. "skills": [
  40. "./skills/infrastructure"
  41. ],
  42. "category": "infrastructure",
  43. "keywords": [
  44. "harness",
  45. "services",
  46. "environments",
  47. "connectors",
  48. "secrets"
  49. ],
  50. "author": {
  51. "name": "Harness"
  52. },
  53. "repository": "https://github.com/harness/harness-skills",
  54. "license": "Apache-2.0"
  55. },
  56. {
  57. "name": "harness-access-control",
  58. "displayName": "Harness Access Control & Users",
  59. "description": "2 skills: Manage users, user groups, service accounts, roles, resource groups and RBAC assignments.",
  60. "source": ".",
  61. "strict": false,
  62. "skills": [
  63. "./skills/access-control"
  64. ],
  65. "category": "security",
  66. "keywords": [
  67. "harness",
  68. "rbac",
  69. "users",
  70. "roles"
  71. ],
  72. "author": {
  73. "name": "Harness"
  74. },
  75. "repository": "https://github.com/harness/harness-skills",
  76. "license": "Apache-2.0"
  77. },
  78. {
  79. "name": "harness-fme",
  80. "displayName": "Harness FME (Feature Flags & Experimentation)",
  81. "description": "16 skills: Discover, create, target, roll out, clean up and experiment with Harness FME feature flags, segments and metrics.",
  82. "source": ".",
  83. "strict": false,
  84. "skills": [
  85. "./skills/fme"
  86. ],
  87. "category": "feature-flags",
  88. "keywords": [
  89. "harness",
  90. "fme",
  91. "feature-flags",
  92. "experimentation",
  93. "split"
  94. ],
  95. "author": {
  96. "name": "Harness"
  97. },
  98. "repository": "https://github.com/harness/harness-skills",
  99. "license": "Apache-2.0"
  100. },
  101. {
  102. "name": "harness-database",
  103. "displayName": "Harness Database DevOps",
  104. "description": "1 skill: Generate, review and run Liquibase changesets with Harness Database DevOps.",
  105. "source": ".",
  106. "strict": false,
  107. "skills": [
  108. "./skills/database"
  109. ],
  110. "category": "database",
  111. "keywords": [
  112. "harness",
  113. "database",
  114. "liquibase",
  115. "dbops"
  116. ],
  117. "author": {
  118. "name": "Harness"
  119. },
  120. "repository": "https://github.com/harness/harness-skills",
  121. "license": "Apache-2.0"
  122. },
  123. {
  124. "name": "harness-platform",
  125. "displayName": "Harness Platform Operations",
  126. "description": "8 skills: Operate delegates, IaCM workspaces, cloud development environments, artifact registries, SBOMs, supply chain and pull requests.",
  127. "source": ".",
  128. "strict": false,
  129. "skills": [
  130. "./skills/platform"
  131. ],
  132. "category": "platform",
  133. "keywords": [
  134. "harness",
  135. "delegates",
  136. "iacm",
  137. "cde",
  138. "artifacts",
  139. "sbom"
  140. ],
  141. "author": {
  142. "name": "Harness"
  143. },
  144. "repository": "https://github.com/harness/harness-skills",
  145. "license": "Apache-2.0"
  146. },
  147. {
  148. "name": "harness-security",
  149. "displayName": "Harness Security Testing & Supply Chain",
  150. "description": "11 skills: Add STO code, secret, container and DAST scans, SLSA provenance and artifact signing, and manage exemptions and PR attestation.",
  151. "source": ".",
  152. "strict": false,
  153. "skills": [
  154. "./skills/security"
  155. ],
  156. "category": "security",
  157. "keywords": [
  158. "harness",
  159. "sto",
  160. "security",
  161. "slsa",
  162. "signing"
  163. ],
  164. "author": {
  165. "name": "Harness"
  166. },
  167. "repository": "https://github.com/harness/harness-skills",
  168. "license": "Apache-2.0"
  169. },
  170. {
  171. "name": "harness-observability-governance",
  172. "displayName": "Harness Observability & Governance",
  173. "description": "19 skills: Costs, DORA, SLOs, chaos, scorecards, audits, OPA policies, IDP, SEI analytics and deployment risk insights.",
  174. "source": ".",
  175. "strict": false,
  176. "skills": [
  177. "./skills/observability-governance"
  178. ],
  179. "category": "observability",
  180. "keywords": [
  181. "harness",
  182. "observability",
  183. "governance",
  184. "chaos",
  185. "slo",
  186. "opa"
  187. ],
  188. "author": {
  189. "name": "Harness"
  190. },
  191. "repository": "https://github.com/harness/harness-skills",
  192. "license": "Apache-2.0"
  193. },
  194. {
  195. "name": "harness-unified-data-platform",
  196. "displayName": "Harness Unified Data Platform",
  197. "description": "1 skill: Query Harness data with HQL: discover queryable types and fields, then write, validate and run queries.",
  198. "source": ".",
  199. "strict": false,
  200. "skills": [
  201. "./skills/unified-data-platform"
  202. ],
  203. "category": "data",
  204. "keywords": [
  205. "harness",
  206. "hql",
  207. "analytics",
  208. "udp"
  209. ],
  210. "author": {
  211. "name": "Harness"
  212. },
  213. "repository": "https://github.com/harness/harness-skills",
  214. "license": "Apache-2.0"
  215. },
  216. {
  217. "name": "harness-agents",
  218. "displayName": "Harness AI Agents",
  219. "description": "2 skills: Create Harness AI agents and agent templates for agentic pipeline workflows.",
  220. "source": ".",
  221. "strict": false,
  222. "skills": [
  223. "./skills/agents"
  224. ],
  225. "category": "ai-agents",
  226. "keywords": [
  227. "harness",
  228. "agents",
  229. "ai"
  230. ],
  231. "author": {
  232. "name": "Harness"
  233. },
  234. "repository": "https://github.com/harness/harness-skills",
  235. "license": "Apache-2.0"
  236. }
  237. ]
  238. }
README.md · README · 602 lines
  1. # Harness Skills
  2. Model-agnostic AI coding 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.
  3. This repository is designed as a workflow system, not just a folder of prompts. The top-level instructions (`AGENTS.md`, with `CLAUDE.md` importing it for Claude Code, plus `.cursor/rules/harness.mdc` and `.github/copilot-instructions.md`) establish shared behavior when you work from a clone, while individual skills specialize in creation, debugging, governance, and reporting tasks. Plugin installs ship those instruction files but do not load them; see [Install as a Claude Code Plugin](#install-as-a-claude-code-plugin).
  4. ## Prerequisites
  5. - [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. It is not bundled with any plugin; see [MCP Setup](#mcp-setup).
  6. ## Available Skills
  7. The tables below are generated from `skills/categories.json` and each skill's frontmatter. Claude Code invokes a skill as `/<plugin>:<skill>`; Cursor, Codex, and other tools use the skill name.
  8. <!-- BEGIN GENERATED:skills -->
  9. <!-- Generated by scripts/generate_catalog.py from skills/categories.json and SKILL.md frontmatter. Do not edit. -->
  10. ### Harness Pipelines & Execution
  11. Plugin `harness-pipelines` (9 skills), folder `skills/pipelines/`.
  12. Install in Claude Code: `/plugin install harness-pipelines --marketplace harness/harness-skills`.
  13. | Skill | Invoke in Claude Code | Description |
  14. |-------|------------------------|-------------|
  15. | [create-pipeline](skills/pipelines/create-pipeline/SKILL.md) | `/harness-pipelines:create-pipeline` | Generate v0 pipeline YAML (CI, CD, combined, approvals) |
  16. | [create-pipeline-v1](skills/pipelines/create-pipeline-v1/SKILL.md) | `/harness-pipelines:create-pipeline-v1` | Generate v1 simplified pipeline YAML |
  17. | [create-template](skills/pipelines/create-template/SKILL.md) | `/harness-pipelines:create-template` | Create reusable step, stage, pipeline, and step group templates |
  18. | [create-trigger](skills/pipelines/create-trigger/SKILL.md) | `/harness-pipelines:create-trigger` | Create webhook, scheduled, and artifact triggers |
  19. | [debug-pipeline](skills/pipelines/debug-pipeline/SKILL.md) | `/harness-pipelines:debug-pipeline` | Diagnose pipeline execution failures |
  20. | [enable-code-coverage](skills/pipelines/enable-code-coverage/SKILL.md) | `/harness-pipelines:enable-code-coverage` | Onboard repositories to Harness Code Coverage with PR gating and baseline triggers |
  21. | [manage-freeze-windows](skills/pipelines/manage-freeze-windows/SKILL.md) | `/harness-pipelines:manage-freeze-windows` | Create, toggle, and manage deployment freeze windows and the project-level global freeze |
  22. | [migrate-pipeline](skills/pipelines/migrate-pipeline/SKILL.md) | `/harness-pipelines:migrate-pipeline` | Convert v0 pipelines to v1 format |
  23. | [run-pipeline](skills/pipelines/run-pipeline/SKILL.md) | `/harness-pipelines:run-pipeline` | Execute and monitor pipeline runs |
  24. ### Harness Infrastructure & Resources
  25. Plugin `harness-infrastructure` (5 skills), folder `skills/infrastructure/`.
  26. Install in Claude Code: `/plugin install harness-infrastructure --marketplace harness/harness-skills`.
  27. | Skill | Invoke in Claude Code | Description |
  28. |-------|------------------------|-------------|
  29. | [create-connector](skills/infrastructure/create-connector/SKILL.md) | `/harness-infrastructure:create-connector` | Create connectors (GitHub, AWS, GCP, Azure, Docker, K8s) |
  30. | [create-environment](skills/infrastructure/create-environment/SKILL.md) | `/harness-infrastructure:create-environment` | Create environments (PreProduction, Production) with overrides |
  31. | [create-infrastructure](skills/infrastructure/create-infrastructure/SKILL.md) | `/harness-infrastructure:create-infrastructure` | Define infrastructure (K8s, ECS, Serverless) |
  32. | [create-secret](skills/infrastructure/create-secret/SKILL.md) | `/harness-infrastructure:create-secret` | Manage secrets (SecretText, SecretFile, SSHKey, WinRM) |
  33. | [create-service](skills/infrastructure/create-service/SKILL.md) | `/harness-infrastructure:create-service` | Define services (Kubernetes, Helm, ECS) with artifact sources |
  34. ### Harness Access Control & Users
  35. Plugin `harness-access-control` (2 skills), folder `skills/access-control/`.
  36. Install in Claude Code: `/plugin install harness-access-control --marketplace harness/harness-skills`.
  37. | Skill | Invoke in Claude Code | Description |
  38. |-------|------------------------|-------------|
  39. | [manage-roles](skills/access-control/manage-roles/SKILL.md) | `/harness-access-control:manage-roles` | RBAC roles, assignments, permissions, and resource groups |
  40. | [manage-users](skills/access-control/manage-users/SKILL.md) | `/harness-access-control:manage-users` | Manage users, user groups, and service accounts |
  41. ### Harness FME (Feature Flags & Experimentation)
  42. Plugin `harness-fme` (16 skills), folder `skills/fme/`.
  43. Install in Claude Code: `/plugin install harness-fme --marketplace harness/harness-skills`.
  44. | Skill | Invoke in Claude Code | Description |
  45. |-------|------------------------|-------------|
  46. | [choose-metric](skills/fme/choose-metric/SKILL.md) | `/harness-fme:choose-metric` | Recommend primary/guardrail metrics for an experiment or rollout, judged against a good-metric checklist |
  47. | [cleanup-feature-flags](skills/fme/cleanup-feature-flags/SKILL.md) | `/harness-fme:cleanup-feature-flags` | Remove a launched FME flag from code and open a PR; archive is handed to manage-flag-lifecycle |
  48. | [create-experiment](skills/fme/create-experiment/SKILL.md) | `/harness-fme:create-experiment` | Creation-only entry point to the manage-experiments workflow |
  49. | [create-feature-flag](skills/fme/create-feature-flag/SKILL.md) | `/harness-fme:create-feature-flag` | Create an FME flag that follows project conventions, with safe-default definitions |
  50. | [create-metric](skills/fme/create-metric/SKILL.md) | `/harness-fme:create-metric` | Design and create an FME metric, with intent-to-config guidance, traffic type, events, cap, and owners |
  51. | [discover-feature-flags](skills/fme/discover-feature-flags/SKILL.md) | `/harness-fme:discover-feature-flags` | Inventory, targeting-pattern search, promotion-aware rollout report, and stale-flag audit (read-only) |
  52. | [explain-flag](skills/fme/explain-flag/SKILL.md) | `/harness-fme:explain-flag` | Explain one flag's purpose, treatments, and per-environment targeting, flagging inconsistencies (read-only) |
  53. | [feature-flag-onboarding](skills/fme/feature-flag-onboarding/SKILL.md) | `/harness-fme:feature-flag-onboarding` | Set up and verify a first feature flag in an existing project; resume partial onboarding |
  54. | [fme-pipeline](skills/fme/fme-pipeline/SKILL.md) | `/harness-fme:fme-pipeline` | Generate FME pipelines for rollout scenarios, gates, and flag lifecycle |
  55. | [instrument-feature-flag](skills/fme/instrument-feature-flag/SKILL.md) | `/harness-fme:instrument-feature-flag` | Gate application code through an extensible flag abstraction, after stack detection and clarification |
  56. | [instrument-metric](skills/fme/instrument-metric/SKILL.md) | `/harness-fme:instrument-metric` | Wire up a track() call for a metric's event, placed at the real outcome, and verify it arrives |
  57. | [manage-experiments](skills/fme/manage-experiments/SKILL.md) | `/harness-fme:manage-experiments` | Feature-flag experiment design/lifecycle; delegates metrics and states CLI update limitations |
  58. | [manage-flag-lifecycle](skills/fme/manage-flag-lifecycle/SKILL.md) | `/harness-fme:manage-flag-lifecycle` | Flag metadata, archive readiness, archive/unarchive, and delete |
  59. | [manage-segments](skills/fme/manage-segments/SKILL.md) | `/harness-fme:manage-segments` | Segment metadata, STANDARD membership, and RULE_BASED editor workflows with mandatory pre-write reference checks |
  60. | [review-experiment-results](skills/fme/review-experiment-results/SKILL.md) | `/harness-fme:review-experiment-results` | Explain experiment results, including winner, significance, guardrail impact, and data-quality caveats |
  61. | [update-flag-targeting](skills/fme/update-flag-targeting/SKILL.md) | `/harness-fme:update-flag-targeting` | Ramp, rules, individual targets, allocation, treatments, kill/restore, env-to-env copy, and initializing definitions |
  62. ### Harness Database DevOps
  63. Plugin `harness-database` (1 skill), folder `skills/database/`.
  64. Install in Claude Code: `/plugin install harness-database --marketplace harness/harness-skills`.
  65. | Skill | Invoke in Claude Code | Description |
  66. |-------|------------------------|-------------|
  67. | [dbops-changeset](skills/database/dbops-changeset/SKILL.md) | `/harness-database:dbops-changeset` | Generate, refine, review, and execute Liquibase changesets with Harness DBOPS |
  68. ### Harness Platform Operations
  69. Plugin `harness-platform` (8 skills), folder `skills/platform/`.
  70. Install in Claude Code: `/plugin install harness-platform --marketplace harness/harness-skills`.
  71. | Skill | Invoke in Claude Code | Description |
  72. |-------|------------------------|-------------|
  73. | [create-sbom](skills/platform/create-sbom/SKILL.md) | `/harness-platform:create-sbom` | Add SBOM Orchestration (generation/attestation) to existing pipelines |
  74. | [enforce-sbom](skills/platform/enforce-sbom/SKILL.md) | `/harness-platform:enforce-sbom` | Add SBOM Policy Enforcement (verify attestation + OPA policy sets) |
  75. | [manage-artifacts](skills/platform/manage-artifacts/SKILL.md) | `/harness-platform:manage-artifacts` | Artifact registry setup, security scanning, and cross-region replication |
  76. | [manage-cde](skills/platform/manage-cde/SKILL.md) | `/harness-platform:manage-cde` | Cloud development environments, workspace templates, and auto-hibernation |
  77. | [manage-delegates](skills/platform/manage-delegates/SKILL.md) | `/harness-platform:manage-delegates` | Monitor delegate health and manage registration tokens |
  78. | [manage-iacm](skills/platform/manage-iacm/SKILL.md) | `/harness-platform:manage-iacm` | Terraform workspaces, drift detection, cost estimation, and approval workflows |
  79. | [manage-pull-requests](skills/platform/manage-pull-requests/SKILL.md) | `/harness-platform:manage-pull-requests` | List, create, update, merge, review, and comment on Harness Code pull requests |
  80. | [manage-supply-chain](skills/platform/manage-supply-chain/SKILL.md) | `/harness-platform:manage-supply-chain` | SBOM generation, artifact signing, and supply chain policy enforcement |
  81. ### Harness Security Testing & Supply Chain
  82. Plugin `harness-security` (11 skills), folder `skills/security/`.
  83. Install in Claude Code: `/plugin install harness-security --marketplace harness/harness-skills`.
  84. | Skill | Invoke in Claude Code | Description |
  85. |-------|------------------------|-------------|
  86. | [approve-exempt](skills/security/approve-exempt/SKILL.md) | `/harness-security:approve-exempt` | Approve pending STO exemptions at current scope or elevate to Project, Org, or Account |
  87. | [configure-agent-pr-attestation](skills/security/configure-agent-pr-attestation/SKILL.md) | `/harness-security:configure-agent-pr-attestation` | Install and configure the Claude Code PR attestation hook for signed in-toto attestations to the Harness Evidence Vault |
  88. | [configure-container-scan](skills/security/configure-container-scan/SKILL.md) | `/harness-security:configure-container-scan` | Add container image scanning to pipelines using Harness STO scanners (Trivy, Grype, Snyk, and more) |
  89. | [configure-dast-scan](skills/security/configure-dast-scan/SKILL.md) | `/harness-security:configure-dast-scan` | Add DAST scanning to pipelines for runtime application security testing (Traceable, Burp Suite, ZAP, Nikto, Nmap) |
  90. | [configure-repo-scan](skills/security/configure-repo-scan/SKILL.md) | `/harness-security:configure-repo-scan` | Configure code scanning in pipelines with STO security scanners |
  91. | [configure-secret-scan](skills/security/configure-secret-scan/SKILL.md) | `/harness-security:configure-secret-scan` | Add secret detection scanning to pipelines to find exposed credentials and API keys (Gitleaks, Semgrep, Snyk, and more) |
  92. | [enforce-slsa](skills/security/enforce-slsa/SKILL.md) | `/harness-security:enforce-slsa` | Add SLSA Verification (verify attestation + OPA policy sets on provenance) to pipelines |
  93. | [exempt-vuln](skills/security/exempt-vuln/SKILL.md) | `/harness-security:exempt-vuln` | Create STO vulnerability exemptions (waivers) scoped to Project, Pipeline, or Target |
  94. | [generate-slsa](skills/security/generate-slsa/SKILL.md) | `/harness-security:generate-slsa` | Add SLSA Generation (provenance + optional Cosign attestation) to existing pipelines |
  95. | [sign-artifact](skills/security/sign-artifact/SKILL.md) | `/harness-security:sign-artifact` | Add Artifact Signing (Cosign sign + optional .sig upload) to existing pipelines (SSCA) |
  96. | [verify-sign](skills/security/verify-sign/SKILL.md) | `/harness-security:verify-sign` | Add Artifact Verification (verify Cosign signature) to existing pipelines (SSCA) |
  97. ### Harness Observability & Governance
  98. Plugin `harness-observability-governance` (19 skills), folder `skills/observability-governance/`.
  99. Install in Claude Code: `/plugin install harness-observability-governance --marketplace harness/harness-skills`.
  100. | Skill | Invoke in Claude Code | Description |
  101. |-------|------------------------|-------------|
  102. | [ai-operations](skills/observability-governance/ai-operations/SKILL.md) | `/harness-observability-governance:ai-operations` | Predictive failure analysis and intelligent alert correlation (AIDA) |
  103. | [analyze-costs](skills/observability-governance/analyze-costs/SKILL.md) | `/harness-observability-governance:analyze-costs` | Cloud cost analysis, recommendations, and anomaly detection |
  104. | [audit-report](skills/observability-governance/audit-report/SKILL.md) | `/harness-observability-governance:audit-report` | Audit trails and compliance evidence (SOC2, GDPR, HIPAA) |
  105. | [chaos-code-risk-scan](skills/observability-governance/chaos-code-risk-scan/SKILL.md) | `/harness-observability-governance:chaos-code-risk-scan` | Scan a code repository for chaos-provable resilience risks and report them as a risk scan |
  106. | [chaos-dr-test](skills/observability-governance/chaos-dr-test/SKILL.md) | `/harness-observability-governance:chaos-dr-test` | Create and edit DR Test pipelines with chaos steps |
  107. | [chaos-experiment](skills/observability-governance/chaos-experiment/SKILL.md) | `/harness-observability-governance:chaos-experiment` | Create, edit, and reference chaos experiments (faults, probes, actions) |
  108. | [create-policy](skills/observability-governance/create-policy/SKILL.md) | `/harness-observability-governance:create-policy` | Create OPA governance policies for supply chain security |
  109. | [deployment-readiness](skills/observability-governance/deployment-readiness/SKILL.md) | `/harness-observability-governance:deployment-readiness` | Pre-deployment readiness checks, environment drift, and canary decisions |
  110. | [dora-metrics](skills/observability-governance/dora-metrics/SKILL.md) | `/harness-observability-governance:dora-metrics` | DORA metrics and engineering performance reports |
  111. | [gitops-status](skills/observability-governance/gitops-status/SKILL.md) | `/harness-observability-governance:gitops-status` | GitOps application health, sync status, and pod logs |
  112. | [incident-response](skills/observability-governance/incident-response/SKILL.md) | `/harness-observability-governance:incident-response` | Deployment-incident correlation, blast radius analysis, and postmortems |
  113. | [manage-idp](skills/observability-governance/manage-idp/SKILL.md) | `/harness-observability-governance:manage-idp` | Service catalog, self-service workflows, documentation, and developer onboarding (IDP) |
  114. | [manage-slos](skills/observability-governance/manage-slos/SKILL.md) | `/harness-observability-governance:manage-slos` | SLO definition, error budgets, incident detection, and operational runbooks |
  115. | [optimize-pipeline](skills/observability-governance/optimize-pipeline/SKILL.md) | `/harness-observability-governance:optimize-pipeline` | Pipeline speed optimization, parallel testing, caching, and monorepo builds |
  116. | [pr-analysis](skills/observability-governance/pr-analysis/SKILL.md) | `/harness-observability-governance:pr-analysis` | PR pipeline impact, security review, and PR-to-production tracking |
  117. | [scorecard-review](skills/observability-governance/scorecard-review/SKILL.md) | `/harness-observability-governance:scorecard-review` | IDP scorecards and service maturity review |
  118. | [security-report](skills/observability-governance/security-report/SKILL.md) | `/harness-observability-governance:security-report` | Security vulnerabilities, SBOMs, and compliance reports |
  119. | [sei-analytics](skills/observability-governance/sei-analytics/SKILL.md) | `/harness-observability-governance:sei-analytics` | Sprint analytics, investment allocation, capacity forecasting, and release readiness |
  120. | [template-usage](skills/observability-governance/template-usage/SKILL.md) | `/harness-observability-governance:template-usage` | Template dependency tracking, impact analysis, and adoption |
  121. ### Harness Unified Data Platform
  122. Plugin `harness-unified-data-platform` (1 skill), folder `skills/unified-data-platform/`.
  123. Install in Claude Code: `/plugin install harness-unified-data-platform --marketplace harness/harness-skills`.
  124. | Skill | Invoke in Claude Code | Description |
  125. |-------|------------------------|-------------|
  126. | [write-hql](skills/unified-data-platform/write-hql/SKILL.md) | `/harness-unified-data-platform:write-hql` | Discover fields, then write, validate, and run dashboard-ready HQL queries |
  127. ### Harness AI Agents
  128. Plugin `harness-agents` (2 skills), folder `skills/agents/`.
  129. Install in Claude Code: `/plugin install harness-agents --marketplace harness/harness-skills`.
  130. | Skill | Invoke in Claude Code | Description |
  131. |-------|------------------------|-------------|
  132. | [create-agent](skills/agents/create-agent/SKILL.md) | `/harness-agents:create-agent` | Create and update Harness AI agent instances for agentic pipeline workflows |
  133. | [create-agent-template](skills/agents/create-agent-template/SKILL.md) | `/harness-agents:create-agent-template` | Generate AI agent templates (metadata.json, pipeline.yaml, wiki.MD) |
  134. <!-- END GENERATED:skills -->
  135. ## Install as a Claude Code Plugin
  136. Each category is its own plugin. On Claude Code 2.1.275 or later, install one in a single step (swap `harness-fme` for any plugin in the tables above; each table shows its own install line):
  137. ```
  138. /plugin install harness-fme --marketplace harness/harness-skills
  139. ```
  140. On older versions, add the marketplace first, then install:
  141. ```
  142. /plugin marketplace add harness/harness-skills
  143. /plugin install harness-fme@harness-skills
  144. ```
  145. The same from a shell:
  146. ```bash
  147. claude plugin install harness-fme --marketplace harness/harness-skills
  148. # older versions: add the marketplace first
  149. claude plugin marketplace add harness/harness-skills
  150. claude plugin install harness-fme@harness-skills
  151. ```
  152. Invoke an installed skill as `/<plugin>:<skill>`:
  153. ```
  154. /harness-fme:explain-flag
  155. Explain the new_checkout flag in production
  156. ```
  157. To update, run `/plugin marketplace update harness-skills`. Plugins are versioned by git commit. Each installed plugin caches a full copy of this repository (about 8 MB), because skills link to the shared `references/` and `templates/` at the repo root. Installing all nine plugins stores nine copies.
  158. **Known gap:** plugin installs do not load the repo-level `AGENTS.md` rules (scope establishment, dependency checks, schema validation). FME skills load their shared rules through `references/fme/`; other skills rely on their own instructions. To get the repo-level rules, work from a clone (see [Quick Start without a plugin](#quick-start-without-a-plugin)).
  159. ## Install as a Cursor Plugin
  160. Cursor installs the whole repository as one plugin, `harness-skills`, containing every skill in the tables above. Invoke a skill as `/<skill>`, for example `/explain-flag`.
  161. - **Team and Enterprise:** in the Cursor dashboard, open Plugins & MCPs, choose Add Marketplace, and import the GitHub repository `harness/harness-skills`.
  162. - **Local install:** clone into Cursor's local plugin folder:
  163. ```bash
  164. git clone https://github.com/harness/harness-skills.git ~/.cursor/plugins/local/harness-skills
  165. ```
  166. - **Public marketplace:** a listing in the public Cursor marketplace requires a submission at cursor.com/marketplace/publish. That has not been done yet.
  167. Cursor reads `.cursor-plugin/marketplace.json` before `.claude-plugin/marketplace.json`, so it sees the single `harness-skills` plugin rather than the nine Claude Code plugins.
  168. ## Install as a Codex Plugin
  169. Codex also installs the whole repository as one plugin, `harness-skills`:
  170. ```bash
  171. codex plugin marketplace add harness/harness-skills
  172. codex
  173. ```
  174. In Codex, open `/plugins`, install `harness-skills`, and start a new session.
  175. To enable it for one repository only, add this to `.codex/config.toml` in that repository:
  176. ```toml
  177. [plugins."harness-skills@harness-skills"]
  178. enabled = true
  179. ```
  180. Codex refreshes an installed plugin only when its version changes. The version is `version` in `skills/categories.json`, so Codex users do not see new skill content until that version is bumped.
  181. ## Quick Start without a plugin
  182. Clone the repository to use the skills, the shared playbooks, and the repo-level rules together in any coding agent:
  183. ```bash
  184. git clone https://github.com/harness/harness-skills.git
  185. ```
  186. Skill files live at `skills/<category>/<skill>/SKILL.md`, for example `skills/pipelines/create-pipeline/SKILL.md`.
  187. ### FME with CLI or MCP (any coding agent)
  188. 1. Keep the repository's `skills/`, shared `references/`, and `templates/` available together. Load `AGENTS.md` and the selected skill; referencing just its SKILL.md without the linked playbooks is insufficient.
  189. 2. Choose the transport available to your agent: a preconfigured Harness CLI with shell access, or the [Harness MCP server](https://github.com/harness/mcp-server). Confirm the account, organization, project and intended environments without exposing credentials. CLI-only FME sessions do not require MCP; authentication should use the tool's supported secure setup outside the prompt.
  190. 3. Read the [FME tool map](references/fme/tool-map.md#transport-preflight-and-handoffs) and check capabilities for the installed version. It documents unsupported operations; CLI/MCP support is not identical. Segment key operations require MCP; some experiment updates also require MCP.
  191. 4. Use the skill file as instructions even if the host has no slash-skill invocation. Load linked skills explicitly during handoffs. Code-editing workflows also need the application repository and its test tools; live verification additionally needs an authorized running application.
  192. The MCP examples in [MCP Setup](#mcp-setup) apply to MCP-powered sessions, not as a prerequisite for every FME workflow. See the [MCP setup playbook](references/mcp-setup.md) for connection, authentication, and read-only verification guidance.
  193. ### Claude Code
  194. Run Claude Code from the clone; project rules load via `CLAUDE.md` -> `@AGENTS.md`:
  195. ```bash
  196. cd harness-skills
  197. claude
  198. ```
  199. To invoke the skills as slash commands, add the clone as a local marketplace and install the plugins you need:
  200. ```
  201. /plugin marketplace add ./
  202. /plugin install harness-pipelines@harness-skills
  203. ```
  204. Then invoke skills by plugin and name:
  205. ```
  206. /harness-pipelines:create-pipeline
  207. Create a CI pipeline for a Node.js app that builds, runs tests,
  208. and pushes a Docker image to ECR
  209. ```
  210. ### Cursor
  211. 1. Clone the repo into your project or as a reference workspace.
  212. 2. The repo includes `.cursor/rules/harness.mdc`, which carries the same project rules as `AGENTS.md`.
  213. 3. Configure the Harness MCP server as described in [MCP Setup](#mcp-setup).
  214. 4. Reference individual skills in your prompts using `@file`:
  215. ```
  216. @harness-skills/skills/pipelines/create-pipeline/SKILL.md
  217. Create a CI pipeline for my Go service
  218. ```
  219. ### OpenAI Codex
  220. 1. Clone the repo into your working directory.
  221. 2. The repo includes `AGENTS.md` at the root, which Codex reads as project instructions.
  222. 3. Configure the Harness MCP server as described in [MCP Setup](#mcp-setup).
  223. 4. Reference individual skill files as context when prompting:
  224. ```
  225. Using the instructions in harness-skills/skills/pipelines/debug-pipeline/SKILL.md,
  226. diagnose why my deploy pipeline failed
  227. ```
  228. ### GitHub Copilot
  229. 1. Clone the repo into your project.
  230. 2. The repo includes `.github/copilot-instructions.md`, which Copilot automatically reads as project-level context in both GitHub.com and VS Code.
  231. 3. For VS Code, configure the Harness MCP server as described in [MCP Setup](#mcp-setup).
  232. 4. Reference skill files in Copilot Chat using `#file`:
  233. ```
  234. #file:harness-skills/skills/pipelines/create-pipeline/SKILL.md
  235. Create a CI pipeline for my Python service
  236. ```
  237. 5. For GitHub Copilot on GitHub.com, attach skill files as context in Copilot Chat or add them as knowledge base references in your Copilot organization settings.
  238. ### Windsurf / Other AI Editors
  239. The skills in this repo are plain Markdown files with YAML frontmatter. They work with any AI coding tool that supports:
  240. 1. **System instructions** - Use `AGENTS.md` as project-level context (`CLAUDE.md` imports it for Claude Code).
  241. 2. **Resource access** - Connect the [Harness MCP server](https://github.com/harness/mcp-server), or use the Harness CLI for supported FME operations.
  242. 3. **File context** - Reference individual `SKILL.md` files under `skills/<category>/<skill>/` in prompts.
  243. ### npx skills add
  244. `npx skills add harness/harness-skills` copies only the skill folders, so skills that link to the shared `references/` and `templates/` at the repo root lose those files. Prefer a plugin install or a clone until bundling ships.
  245. ## MCP Setup
  246. The Harness MCP server is not bundled with any plugin; configure it for each tool you use. The examples run the server locally with `npx`. Never commit a real API key: use an environment reference or a placeholder like `<your-api-key>`. See the [MCP setup playbook](references/mcp-setup.md) for hosted vs. local servers, authentication, and read-only verification.
  247. ### Claude Code
  248. Add a `.mcp.json` at the root of your own project (not this repo's root). Claude Code expands `${VAR}` from your environment, so the key stays out of the file:
  249. ```json
  250. {
  251. "mcpServers": {
  252. "harness-mcp-v2": {
  253. "command": "npx",
  254. "args": ["-y", "harness-mcp-v2"],
  255. "env": {
  256. "HARNESS_API_KEY": "${HARNESS_API_KEY}"
  257. }
  258. }
  259. }
  260. }
  261. ```
  262. `claude mcp add --scope project` writes the same file (see `claude mcp add --help`). An `mcpServers` entry in `~/.claude/settings.json` is not read as MCP configuration.
  263. ### Cursor
  264. Add to `~/.cursor/mcp.json` (user-level) or `.cursor/mcp.json` (project-level):
  265. ```json
  266. {
  267. "mcpServers": {
  268. "harness-mcp-v2": {
  269. "command": "npx",
  270. "args": ["-y", "harness-mcp-v2"],
  271. "env": {
  272. "HARNESS_API_KEY": "<your-api-key>"
  273. }
  274. }
  275. }
  276. }
  277. ```
  278. ### OpenAI Codex
  279. Codex reads MCP servers from `~/.codex/config.toml` as TOML tables, not JSON. `env_vars` forwards the named variables from your shell environment:
  280. ```toml
  281. [mcp_servers.harness-mcp-v2]
  282. command = "npx"
  283. args = ["-y", "harness-mcp-v2"]
  284. env_vars = ["HARNESS_API_KEY"]
  285. ```
  286. ### VS Code (GitHub Copilot)
  287. Add to `.vscode/mcp.json` in the workspace. This file is usually committed, so do not put a real key in it:
  288. ```json
  289. {
  290. "servers": {
  291. "harness-mcp-v2": {
  292. "command": "npx",
  293. "args": ["-y", "harness-mcp-v2"],
  294. "env": {
  295. "HARNESS_API_KEY": "<your-api-key>"
  296. }
  297. }
  298. }
  299. }
  300. ```
  301. ## Team Setup (Claude Code)
  302. To have teammates prompted to install the plugins, commit a project `.claude/settings.json`:
  303. ```json
  304. {
  305. "extraKnownMarketplaces": {
  306. "harness-skills": {
  307. "source": {
  308. "source": "github",
  309. "repo": "harness/harness-skills"
  310. }
  311. }
  312. },
  313. "enabledPlugins": {
  314. "harness-fme@harness-skills": true
  315. }
  316. }
  317. ```
  318. List one `enabledPlugins` entry per plugin the team uses (`<plugin>@harness-skills`).
  319. ## Operating Model
  320. The best Harness skills follow the same control flow even when they target different resource types:
  321. 1. **Establish scope first** - confirm account/org/project context before listing, creating, updating, or deleting resources.
  322. 2. **Verify dependencies before generating dependents** - do not reference connectors, secrets, environments, infrastructure, or templates that have not been confirmed to exist.
  323. 3. **Discover schema before writing payloads** - use MCP `harness_describe` or the installed CLI command specification and documented payload schema; stop when required capabilities are unavailable rather than guessing fields.
  324. These repo-level playbooks live in:
  325. - [`references/scope-establishment.md`](references/scope-establishment.md)
  326. - [`references/dependency-check-playbook.md`](references/dependency-check-playbook.md)
  327. - [`references/schema-validation-loop.md`](references/schema-validation-loop.md)
  328. - [`templates/operation-summary.md`](templates/operation-summary.md)
  329. ## Workflow Modes
  330. | Workflow mode | Representative skills | Use when |
  331. |---------------|-----------------------|----------|
  332. | Create and scaffold | `/create-pipeline`, `/create-service`, `/create-connector`, `/create-template`, `/fme-pipeline` | You need to define or generate new Harness resources and their YAML or MCP payloads. |
  333. | Run and debug | `/run-pipeline`, `/debug-pipeline`, `/migrate-pipeline`, `/manage-delegates` | You already have resources and need to execute, diagnose, or repair behavior. |
  334. | Govern and secure | `/manage-roles`, `/manage-users`, `/create-policy`, `/security-report`, `/audit-report` | You need RBAC, policy, compliance, or security workflows with blast-radius awareness. |
  335. | Analyze and report | `/dora-metrics`, `/analyze-costs`, `/scorecard-review`, `/template-usage` | You need structured reports, summaries, recommendations, or adoption analysis. |
  336. ## End-to-End Workflows
  337. ### New microservice setup
  338. Use these skills in order:
  339. 1. `/create-connector`
  340. 2. `/create-secret`
  341. 3. `/create-service`
  342. 4. `/create-environment`
  343. 5. `/create-infrastructure`
  344. 6. `/create-pipeline`
  345. 7. `/create-trigger`
  346. ### Debug a failed deployment
  347. Typical sequence:
  348. 1. `/run-pipeline` to identify the latest execution or reproduce the issue
  349. 2. `/debug-pipeline` to classify the failure and inspect root cause
  350. 3. `/template-usage` if shared templates may have propagated the issue
  351. 4. `/manage-delegates` if the failure points to delegate capacity or connectivity
  352. ## Migrating from the Flat Layout
  353. Skills moved from `skills/<skill>/` to `skills/<category>/<skill>/`; the categories are listed in `skills/categories.json`. Old deep links and `@harness-skills/skills/<skill>/SKILL.md` references need the category segment:
  354. ```
  355. Before: @harness-skills/skills/<skill>/SKILL.md
  356. After: @harness-skills/skills/<category>/<skill>/SKILL.md
  357. Example: @harness-skills/skills/pipelines/create-pipeline/SKILL.md
  358. ```
  359. Branches opened before the move: merge or rebase `main`, run `python3 scripts/migrate_to_categories.py --repair` (add `--map <new-skill>=<category>` for each skill the script does not know, repeatable), review the changes, and commit. The script is temporary and will be removed after the merge window.
  360. If you installed with `npx skills add`, re-run your install to pick up the new layout.
  361. ## Project Structure
  362. ```
  363. harness-skills/
  364. ├── skills/
  365. │ ├── categories.json # Categories and Claude Code plugins (source of truth)
  366. │ ├── pipelines/ # One folder per category
  367. │ │ ├── create-pipeline/
  368. │ │ │ ├── SKILL.md
  369. │ │ │ └── references/
  370. │ │ ├── debug-pipeline/
  371. │ │ │ └── SKILL.md
  372. │ │ └── ...
  373. │ ├── fme/
  374. │ └── ... # Nine categories in total
  375. ├── references/ # Shared repo-level playbooks
  376. ├── templates/ # Shared repo-level output templates
  377. ├── template/
  378. │ └── SKILL.md.template # Copy-ready skeleton for new skills
  379. ├── scripts/
  380. │ ├── validate-skills.sh # Structural validation of skills
  381. │ ├── generate_catalog.py # Regenerates manifests, skills.json and skill tables (--check for CI)
  382. │ ├── catalog_lib.py # Catalog loading shared by the generators
  383. │ ├── gen_claude.py # Claude Code marketplace generator
  384. │ ├── gen_cursor.py # Cursor plugin generator
  385. │ ├── gen_codex.py # Codex plugin generator
  386. │ ├── check_links.py # Markdown link and path-mention checker
  387. │ └── migrate_to_categories.py # Temporary flat-to-category migration helper
  388. ├── tests/ # Catalog, generator, manifest and link-checker tests
  389. ├── examples/
  390. │ ├── v0/ # v0 pipeline examples
  391. │ ├── v1/ # v1 pipeline examples
  392. │ ├── templates/ # Template examples
  393. │ ├── triggers/ # Trigger examples
  394. │ ├── services/ # Service definition examples
  395. │ ├── environments/ # Environment examples
  396. │ ├── connectors/ # Connector examples
  397. │ └── ...
  398. ├── .claude-plugin/marketplace.json # Generated: Claude Code marketplace (nine plugins)
  399. ├── .cursor-plugin/ # Generated: Cursor marketplace and plugin manifest
  400. ├── .agents/plugins/marketplace.json # Generated: Codex marketplace
  401. ├── .codex-plugin/plugin.json # Generated: Codex plugin manifest
  402. ├── skills.json # Generated: machine-readable skill index
  403. ├── .cursor/rules/harness.mdc # Project rules for Cursor
  404. ├── .github/
  405. │ ├── copilot-instructions.md
  406. │ └── workflows/validate-skills.yml # CI
  407. ├── AGENTS.md # Canonical project rules (Codex, Cursor, etc.)
  408. ├── CLAUDE.md # Imports AGENTS.md for Claude Code
  409. ├── CONTRIBUTING.md # Contribution guidelines
  410. ├── LICENSE
  411. └── README.md
  412. ```
  413. ## Shared Playbooks and Templates
  414. Use root-level shared assets for behavior that should stay consistent across many skills:
  415. - `references/` - reusable operating guidance such as scope establishment, dependency verification, and schema-validation loops
  416. - `templates/` - reusable output contracts such as operation summaries and report formats
  417. Use per-skill `references/` or `templates/` when the content is domain-specific and should not be imported broadly.
  418. ## Skill Anatomy
  419. Each skill is a directory at `skills/<category>/<skill>/` containing a `SKILL.md` with YAML frontmatter and a consistent markdown body: `# Title`, `## Instructions`, `## Examples`, `## Performance Notes`, and `## Troubleshooting`. Start from [`template/SKILL.md.template`](template/SKILL.md.template); [CONTRIBUTING.md](CONTRIBUTING.md) documents the frontmatter fields, description rules, and shared-reference conventions.
  420. For complex skills, add `references/` or `templates/` under the skill directory rather than bloating `SKILL.md`.
  421. ## MCP Tools
  422. MCP-powered skills use the [Harness MCP v2 server](https://github.com/harness/mcp-server), which provides 10 generic tools dispatched by `resource_type`:
  423. | Tool | Purpose |
  424. |------|---------|
  425. | `harness_list` | List resources |
  426. | `harness_get` | Get resource details |
  427. | `harness_create` | Create a resource |
  428. | `harness_update` | Update a resource |
  429. | `harness_delete` | Delete a resource |
  430. | `harness_execute` | Execute an action |
  431. | `harness_search` | Search across resources |
  432. | `harness_describe` | Get resource schema |
  433. | `harness_diagnose` | Diagnose issues |
  434. | `harness_status` | Check system status |
  435. ## Schema References
  436. - [v0 Pipeline/Template/Trigger Schema](https://github.com/harness/harness-schema/tree/main/v0)
  437. - [v1 Pipeline Spec](https://github.com/thisrohangupta/spec)
  438. - [Agent Templates](https://github.com/thisrohangupta/agents)
  439. - [Harness MCP v2 Server](https://github.com/harness/mcp-server)
  440. ## Contributing
  441. See [CONTRIBUTING.md](CONTRIBUTING.md) for skill authoring standards, validation rules, and contribution workflow. Before opening a PR, run the four checks it lists: `scripts/validate-skills.sh`, `python3 scripts/generate_catalog.py` (commit the generated files), `python3 scripts/check_links.py`, and `python3 -m unittest discover -s tests -v`.
  442. ## License
  443. This project is licensed under the [Apache License 2.0](LICENSE).
  444. Copyright 2026 Harness Inc.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.