[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7BWP1FC5CBWFTVYY5H9GSBJ":3,"skill-same:01M7BWP1FC5CBWFTVYY5H9GSBJ":75},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":29,"repositoryHtmlUrl":30,"repositoryHomepageUrl":6,"ownerHtmlUrl":31,"ownerBlogUrl":32,"ownerDescription":33,"updatedAt":34,"install":35,"resources":48},"01M7BWP1FC5CBWFTVYY5H9GSBJ","skill-authoring",null,"Create and improve the skills in your own plugins — the ones incident.io's agents and your coding agents load. Use whenever you're writing, editing, or reviewing a skill in any way: creating one, improving one from usage feedback or a review brief, or asking what makes a good skill.","CognitionAI\u002Fdevin-marketplace","CognitionAI","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F163493330?v=4","01M7BVSRD98NC4FG8T3EZS6V5M","Cognition","01M7BVSRDX111C2XPWJ0E6MY26",29,"MIT","https:\u002F\u002Fgithub.com\u002FCognitionAI\u002Fdevin-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fincident-io\u002Fskills\u002Fskill-authoring\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: skill-authoring\ndescription: >\n  Create and improve the skills in your own plugins — the ones incident.io's agents\n  and your coding agents load. Use whenever you're writing, editing, or reviewing a\n  skill in any way: creating one, improving one from usage feedback or a review\n  brief, or asking what makes a good skill.\nargument-hint: \"\u003Cwhat the skill should do — or the skill to improve and why>\"\n---\n\n# Skill authoring\n\nA skill is instructions your agents follow: a SKILL.md with a triggering description,\nplus references it loads on demand. It lives in a plugin — a repository your\norganization syncs into incident.io and can also install into coding agents. This\nskill owns the authoring craft — what makes a skill get selected, followed, and\nhelpful — and the loop that improves a shipped skill from real usage: incident.io\nrecords each load (one agent using the skill once) and assesses it retrospectively,\nand that feedback drives the improve job.\n\n## The two jobs\n\n- **Create** — author a new skill into the user's plugin: pin it down with concrete\n  trigger examples, check nothing owns the job already, draft to the format, register\n  it, ship it. → [references\u002Fcreate.md](references\u002Fcreate.md)\n- **Improve** — edit an existing skill from evidence: read its usage feedback with\n  improve.md's reading corrections applied, fix by theme without undoing credited\n  strengths, verify the fix against the recorded issue where the session can, ship,\n  confirm. → [references\u002Fimprove.md](references\u002Fimprove.md)\n\nBoth jobs load the same two files before drafting:\n[references\u002Fformat.md](references\u002Fformat.md) — the structural rules (anatomy,\ndescriptions as triggers, environment-neutral tool and datasource naming,\nregistration) — and [references\u002Fwhat-works.md](references\u002Fwhat-works.md) — what the\nbest-performing skills share, from incident.io's own estate and the assessment of\nreal usage. Format answers \"is this valid\"; what-works answers \"will this get\nfollowed\". [references\u002Fexample.md](references\u002Fexample.md) shows both applied to one\nworked skill — read it when you want the target picture rather than more rules.\n\nOne further reference is conditional:\n[references\u002Ftriage-skills.md](references\u002Ftriage-skills.md) — read it when the skill\nshould be reached for by incident.io's investigations, which use installed skills that\nown an incident's system or signature in its opening minutes. Authoring for an automated\ncaller changes three things: the name and description do all of the selecting, the procedure\nruns unattended with nobody to ask, and its findings become someone else's evidence\nrather than a report to a person.\n\n## Where the skills live\n\nThe user's skills belong in their own plugin — a repository their organization\nconnects to incident.io — never in this one. This plugin carries the authoring\njudgment; their content stays theirs. When the user has no plugin yet, plugin setup\nis the `extensions` skill's job — route there, and come back to create the first skill.\n\nEditing happens wherever the session is: in a checkout of the plugin's repository (the\ncommon case — changes ride the team's review flow), or by handing the user finished\nfiles when the session can't reach the repository. Never write into a plugin the user\ndidn't point you at.\n\n## What this skill is not for\n\nRunbooks and architecture docs — those are content with their own formats, owned by\nthe `runbooks` and `architecture` skills in this plugin; a skill is instructions for an\nagent, not knowledge for a person. And reviewing all your plugins at once (\"are our\nskills healthy?\") is the `doctor` skill's job — this skill works one skill at a time,\nfrom evidence about that skill.\n","# Skill authoring\n\nA skill is instructions your agents follow: a SKILL.md with a triggering description,\nplus references it loads on demand. It lives in a plugin — a repository your\norganization syncs into incident.io and can also install into coding agents. This\nskill owns the authoring craft — what makes a skill get selected, followed, and\nhelpful — and the loop that improves a shipped skill from real usage: incident.io\nrecords each load (one agent using the skill once) and assesses it retrospectively,\nand that feedback drives the improve job.\n\n## The two jobs\n\n- **Create** — author a new skill into the user's plugin: pin it down with concrete\n  trigger examples, check nothing owns the job already, draft to the format, register\n  it, ship it. → [references\u002Fcreate.md](references\u002Fcreate.md)\n- **Improve** — edit an existing skill from evidence: read its usage feedback with\n  improve.md's reading corrections applied, fix by theme without undoing credited\n  strengths, verify the fix against the recorded issue where the session can, ship,\n  confirm. → [references\u002Fimprove.md](references\u002Fimprove.md)\n\nBoth jobs load the same two files before drafting:\n[references\u002Fformat.md](references\u002Fformat.md) — the structural rules (anatomy,\ndescriptions as triggers, environment-neutral tool and datasource naming,\nregistration) — and [references\u002Fwhat-works.md](references\u002Fwhat-works.md) — what the\nbest-performing skills share, from incident.io's own estate and the assessment of\nreal usage. Format answers \"is this valid\"; what-works answers \"will this get\nfollowed\". [references\u002Fexample.md](references\u002Fexample.md) shows both applied to one\nworked skill — read it when you want the target picture rather than more rules.\n\nOne further reference is conditional:\n[references\u002Ftriage-skills.md](references\u002Ftriage-skills.md) — read it when the skill\nshould be reached for by incident.io's investigations, which use installed skills that\nown an incident's system or signature in its opening minutes. Authoring for an automated\ncaller changes three things: the name and description do all of the selecting, the procedure\nruns unattended with nobody to ask, and its findings become someone else's evidence\nrather than a report to a person.\n\n## Where the skills live\n\nThe user's skills belong in their own plugin — a repository their organization\nconnects to incident.io — never in this one. This plugin carries the authoring\njudgment; their content stays theirs. When the user has no plugin yet, plugin setup\nis the `extensions` skill's job — route there, and come back to create the first skill.\n\nEditing happens wherever the session is: in a checkout of the plugin's repository (the\ncommon case — changes ride the team's review flow), or by handing the user finished\nfiles when the session can't reach the repository. Never write into a plugin the user\ndidn't point you at.\n\n## What this skill is not for\n\nRunbooks and architecture docs — those are content with their own formats, owned by\nthe `runbooks` and `architecture` skills in this plugin; a skill is instructions for an\nagent, not knowledge for a person. And reviewing all your plugins at once (\"are our\nskills healthy?\") is the `doctor` skill's job — this skill works one skill at a time,\nfrom evidence about that skill.\n",{"name":5,"description":24,"argument-hint":25},"Create and improve the skills in your own plugins — the ones incident.io's agents and your coding agents load. Use whenever you're writing, editing, or reviewing a skill in any way: creating one, improving one from usage feedback or a review brief, or asking what makes a good skill.\n","\u003Cwhat the skill should do — or the skill to improve and why>","main","9836d94e88404aabb682086405c2aa9cba7657ac","plugins\u002Fincident-io\u002Fskills\u002Fskill-authoring",156,"https:\u002F\u002Fgithub.com\u002FCognitionAI\u002Fdevin-marketplace","https:\u002F\u002Fgithub.com\u002FCognitionAI","https:\u002F\u002Fcognition.ai\u002F","Makers of Devin, the AI software engineer.","2026-11-13 07:08:23",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add CognitionAI\u002Fdevin-marketplace --skill skill-authoring",{"tool":41,"command":42},"bunx","bunx skills add CognitionAI\u002Fdevin-marketplace --skill skill-authoring",{"tool":44,"command":45},"pnpm","pnpm dlx skills add CognitionAI\u002Fdevin-marketplace --skill skill-authoring","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FCognitionAI\u002Fdevin-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fincident-io\u002Fskills\u002Fskill-authoring\u002FSKILL.md",true,[49,55,59,63,67,71],{"path":50,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":53,"sourceHtmlUrl":54},"references\u002Fcreate.md","REFERENCE","参考文档",14445,"https:\u002F\u002Fgithub.com\u002FCognitionAI\u002Fdevin-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fincident-io\u002Fskills\u002Fskill-authoring\u002Freferences\u002Fcreate.md",{"path":56,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":57,"sourceHtmlUrl":58},"references\u002Fexample.md",5979,"https:\u002F\u002Fgithub.com\u002FCognitionAI\u002Fdevin-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fincident-io\u002Fskills\u002Fskill-authoring\u002Freferences\u002Fexample.md",{"path":60,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":61,"sourceHtmlUrl":62},"references\u002Fformat.md",13711,"https:\u002F\u002Fgithub.com\u002FCognitionAI\u002Fdevin-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fincident-io\u002Fskills\u002Fskill-authoring\u002Freferences\u002Fformat.md",{"path":64,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":65,"sourceHtmlUrl":66},"references\u002Fimprove.md",10404,"https:\u002F\u002Fgithub.com\u002FCognitionAI\u002Fdevin-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fincident-io\u002Fskills\u002Fskill-authoring\u002Freferences\u002Fimprove.md",{"path":68,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":69,"sourceHtmlUrl":70},"references\u002Ftriage-skills.md",7177,"https:\u002F\u002Fgithub.com\u002FCognitionAI\u002Fdevin-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fincident-io\u002Fskills\u002Fskill-authoring\u002Freferences\u002Ftriage-skills.md",{"path":72,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":73,"sourceHtmlUrl":74},"references\u002Fwhat-works.md",10818,"https:\u002F\u002Fgithub.com\u002FCognitionAI\u002Fdevin-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fincident-io\u002Fskills\u002Fskill-authoring\u002Freferences\u002Fwhat-works.md",[76,82,89,95,102,109],{"skillNo":77,"name":78,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M7BYC4AJGM98P2G9JH7QS24Z","business-data","https:\u002F\u002Fgithub.com\u002FCognitionAI\u002Fdevin-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fwindsor-ai\u002Fskills\u002Fbusiness-data\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M7BYBZ0CD4CBCPZHRZ551BNK","workflow","Creates durable, resumable workflows using Vercel's Workflow SDK. Use when building workflows that need to survive restarts, pause for external events, retry on failure, or coordinate multi-step operations over time. Triggers on mentions of \"workflow\", \"durable functions\", \"resumable\", \"workflow sdk\", \"queue\", \"event\", \"push\", \"subscribe\", or step-based orchestration.","https:\u002F\u002Fgithub.com\u002FCognitionAI\u002Fdevin-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fvercel\u002Fskills\u002Fworkflow\u002Fupstream\u002FSKILL.md",[],[],{"skillNo":90,"name":84,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M7BYB1XSZHKHD8JZTQJ62JN0","Vercel Workflow SDK expert guidance. Use when building durable workflows, long-running tasks, API routes or agents that need pause\u002Fresume, retries, step-based execution, or crash-safe orchestration with Vercel Workflow.","https:\u002F\u002Fgithub.com\u002FCognitionAI\u002Fdevin-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fvercel\u002Fskills\u002Fworkflow\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":19},"01M7BYASGMK935J33E21N5WTW0","verification","Full-story verification — infers what the user is building, then verifies the complete flow end-to-end: browser → API → data → response. Triggers on dev server start and 'why isn't this working' signals.","https:\u002F\u002Fgithub.com\u002FCognitionAI\u002Fdevin-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fvercel\u002Fskills\u002Fverification\u002FSKILL.md",[],[],{"skillNo":103,"name":104,"nameZh":6,"description":105,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":106,"categories":107,"keywords":108,"publishedAt":19},"01M7BY9WJERKSKEH9HK6E71GW2","vercel-storage","Vercel storage expert guidance — Blob, Global Config (formerly Edge Config), and Marketplace storage (Neon Postgres, Upstash Redis). Use when choosing, configuring, or using data storage with Vercel applications.","https:\u002F\u002Fgithub.com\u002FCognitionAI\u002Fdevin-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fvercel\u002Fskills\u002Fvercel-storage\u002FSKILL.md",[],[],{"skillNo":110,"name":111,"nameZh":6,"description":112,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":113,"categories":114,"keywords":115,"publishedAt":19},"01M7BY9N034894YV2J9DCRZHYS","vercel-services","Configure and troubleshoot Vercel Services for multiple frontends and backends in one project. Use when composing a polyglot or multi-service application on one Vercel deployment; defining the `services` key, service-targeted rewrites, or service bindings in `vercel.json`; or running all services with `vercel dev`.","https:\u002F\u002Fgithub.com\u002FCognitionAI\u002Fdevin-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fvercel\u002Fskills\u002Fvercel-services\u002FSKILL.md",[],[]]