{"id":"29f6a30c-3444-4d9c-a75d-fb53ee24028f","shortId":"fysacC","kind":"skill","title":"create-environment","tagline":">-","description":"# Create Environment\n\nGenerate Harness Environment YAML and push to Harness via MCP.\n\n## Instructions\n\n1. **Determine environment type** - `PreProduction` for dev/staging/QA, `Production` for live environments\n2. **Define variables and overrides** - Environment-specific config values and manifest overrides\n3. **Generate YAML** using the structure below\n4. **Create via MCP** using `harness_create` with resource_type `environment`\n\n## Environment Structure\n\n```yaml\nenvironment:\n  name: Staging\n  identifier: staging\n  orgIdentifier: default\n  projectIdentifier: my_project\n  type: PreProduction       # PreProduction or Production\n  tags:\n    tier: staging\n  variables:\n    - name: domain\n      type: String\n      value: staging.myapp.com\n    - name: replicas\n      type: Number\n      value: \"2\"\n    - name: db_password\n      type: Secret\n      value: <+secrets.getValue(\"staging_db_password\")>\n  overrides:\n    manifests:\n      - manifest:\n          identifier: values_override\n          type: Values\n          spec:\n            store:\n              type: Github\n              spec:\n                connectorRef: github\n                repoName: config\n                branch: main\n                paths: [values-staging.yaml]\n```\n\n## Environment Types\n\n- `PreProduction` - Dev, QA, staging, integration environments\n- `Production` - Live production environments (enables additional safeguards)\n\n## Multi-Environment Setup\n\nCreate dev, staging, and prod:\n\n```yaml\n# Dev\nenvironment:\n  name: Development\n  identifier: dev\n  type: PreProduction\n  variables:\n    - name: domain\n      type: String\n      value: dev.myapp.com\n\n# Staging\nenvironment:\n  name: Staging\n  identifier: staging\n  type: PreProduction\n  variables:\n    - name: domain\n      type: String\n      value: staging.myapp.com\n\n# Production\nenvironment:\n  name: Production\n  identifier: prod\n  type: Production\n  variables:\n    - name: domain\n      type: String\n      value: myapp.com\n```\n\n## Creating via MCP\n\n```\nCall MCP tool: harness_create\nParameters:\n  resource_type: \"environment\"\n  org_id: \"<organization>\"\n  project_id: \"<project>\"\n  body: <environment YAML>\n```\n\nList environments:\n```\nCall MCP tool: harness_list\nParameters:\n  resource_type: \"environment\"\n  org_id: \"<organization>\"\n  project_id: \"<project>\"\n```\n\n## Examples\n\n- \"Create dev, staging, and prod environments\" - Generate 3 environments with appropriate types\n- \"Set up a production environment with overrides\" - Production type with manifest overrides\n\n## Performance Notes\n\n- When creating multiple environments (dev/staging/prod), ensure variable values are distinct per environment.\n- Verify that manifest override paths exist in the referenced repository before creating.\n- Use Production type only for live environments — it enables additional safeguards like deployment freezes.\n\n## Troubleshooting\n\n- `DUPLICATE_IDENTIFIER` - Environment exists; use `harness_update`\n- Production type enables deployment freeze and approval guardrails","tags":["create","environment","harness","skills","agent-skills","agents"],"capabilities":["skill","source-harness","skill-create-environment","topic-agent-skills","topic-agents"],"categories":["harness-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/harness/harness-skills/create-environment","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add harness/harness-skills","source_repo":"https://github.com/harness/harness-skills","install_from":"skills.sh"}},"qualityScore":"0.457","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 15 github stars · SKILL.md body (2,980 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:06:29.157Z","embedding":null,"createdAt":"2026-05-09T01:05:27.769Z","updatedAt":"2026-05-18T19:06:29.157Z","lastSeenAt":"2026-05-18T19:06:29.157Z","tsv":"'1':17 '2':28,92 '3':41,234 '4':48 'addit':137,286 'appropri':237 'approv':305 'bodi':210 'branch':120 'call':197,213 'config':36,119 'connectorref':116 'creat':2,4,49,54,143,194,201,227,254,276 'create-environ':1 'db':94,101 'default':68 'defin':29 'deploy':289,302 'determin':18 'dev':127,144,149,154,228 'dev.myapp.com':163 'dev/staging/prod':257 'dev/staging/qa':23 'develop':152 'distinct':262 'domain':82,159,174,189 'duplic':292 'enabl':136,285,301 'ensur':258 'environ':3,5,8,19,27,34,58,59,62,124,131,135,141,150,165,180,205,212,221,232,235,243,256,264,283,294 'environment-specif':33 'exampl':226 'exist':270,295 'freez':290,303 'generat':6,42,233 'github':114,117 'guardrail':306 'har':7,13,53,200,216,297 'id':207,209,223,225 'identifi':65,106,153,168,183,293 'instruct':16 'integr':130 'like':288 'list':211,217 'live':26,133,282 'main':121 'manifest':39,104,105,249,267 'mcp':15,51,196,198,214 'multi':140 'multi-environ':139 'multipl':255 'myapp.com':193 'name':63,81,87,93,151,158,166,173,181,188 'note':252 'number':90 'org':206,222 'orgidentifi':67 'overrid':32,40,103,108,245,250,268 'paramet':202,218 'password':95,102 'path':122,269 'per':263 'perform':251 'preproduct':21,73,74,126,156,171 'prod':147,184,231 'product':24,76,132,134,179,182,186,242,246,278,299 'project':71,208,224 'projectidentifi':69 'push':11 'qa':128 'referenc':273 'replica':88 'reponam':118 'repositori':274 'resourc':56,203,219 'safeguard':138,287 'secret':97 'secrets.getvalue':99 'set':239 'setup':142 'skill' 'skill-create-environment' 'source-harness' 'spec':111,115 'specif':35 'stage':64,66,79,100,129,145,164,167,169,229 'staging.myapp.com':86,178 'store':112 'string':84,161,176,191 'structur':46,60 'tag':77 'tier':78 'tool':199,215 'topic-agent-skills' 'topic-agents' 'troubleshoot':291 'type':20,57,72,83,89,96,109,113,125,155,160,170,175,185,190,204,220,238,247,279,300 'updat':298 'use':44,52,277,296 'valu':37,85,91,98,107,110,162,177,192,260 'values-staging.yaml':123 'variabl':30,80,157,172,187,259 'verifi':265 'via':14,50,195 'yaml':9,43,61,148","prices":[{"id":"a02ee67f-1278-4be7-a6cc-71c7e4d72e65","listingId":"29f6a30c-3444-4d9c-a75d-fb53ee24028f","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"harness","category":"harness-skills","install_from":"skills.sh"},"createdAt":"2026-05-09T01:05:27.769Z"}],"sources":[{"listingId":"29f6a30c-3444-4d9c-a75d-fb53ee24028f","source":"github","sourceId":"harness/harness-skills/create-environment","sourceUrl":"https://github.com/harness/harness-skills/tree/main/skills/create-environment","isPrimary":false,"firstSeenAt":"2026-05-09T01:05:27.769Z","lastSeenAt":"2026-05-18T19:06:29.157Z"}],"details":{"listingId":"29f6a30c-3444-4d9c-a75d-fb53ee24028f","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"harness","slug":"create-environment","github":{"repo":"harness/harness-skills","stars":15,"topics":["agent-skills","agents"],"license":"apache-2.0","html_url":"https://github.com/harness/harness-skills","pushed_at":"2026-05-13T01:28:28Z","description":"A collection of structured AI agent skills that   enable Claude Code, Cursor, GitHub Copilot, and   other AI coding assistants to create, operate,   debug, and govern Harness CI/CD workflows through   natural language.","skill_md_sha":"62d0629b7a3e0b0f8f507afa6e30daa930f0224b","skill_md_path":"skills/create-environment/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/harness/harness-skills/tree/main/skills/create-environment"},"layout":"multi","source":"github","category":"harness-skills","frontmatter":{"name":"create-environment","license":"Apache-2.0","description":">-","compatibility":"Requires Harness MCP v2 server (harness-mcp-v2)"},"skills_sh_url":"https://skills.sh/harness/harness-skills/create-environment"},"updatedAt":"2026-05-18T19:06:29.157Z"}}