[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AGFPH6EESSFJDD8PMK2MJ6":3,"skill-same:01M7AGFPH6EESSFJDD8PMK2MJ6":52},{"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":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":28,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M7AGFPH6EESSFJDD8PMK2MJ6","generate-diagram",null,"Draw a network topology diagram from the device configs and saved show cdp\u002Flldp neighbors detail output in configs\u002F — an SVG, a self-contained HTML preview, Mermaid and D2, and optionally an editable PowerPoint slide. Use when the user asks to draw, map, diagram or visualise the topology, the network, the links between devices, or wants a network diagram for a MOP, a change record, an incident report or a deck. Not for diagnosing a fault (use troubleshoot) or reviewing a config's security (use config-audit).","ciscoittech\u002Fdamira-plugins","ciscoittech","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F12874990?v=4","01M7AGA34QQBQX1NVX7SJEF93Z","Notorious CSV","01M7AGA35B7M33H4QSKVCB013C",0,"MIT","https:\u002F\u002Fgithub.com\u002Fciscoittech\u002Fdamira-plugins\u002Fblob\u002Fmain\u002Fdamira-cursor\u002Fskills\u002Fgenerate-diagram\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: generate-diagram\ndescription: Draw a network topology diagram from the device configs and saved show cdp\u002Flldp neighbors detail output in configs\u002F — an SVG, a self-contained HTML preview, Mermaid and D2, and optionally an editable PowerPoint slide. Use when the user asks to draw, map, diagram or visualise the topology, the network, the links between devices, or wants a network diagram for a MOP, a change record, an incident report or a deck. Not for diagnosing a fault (use troubleshoot) or reviewing a config's security (use config-audit).\n---\n\n# Topology diagrams\n\nThe Damira scripts parse the configs into a spec (`topology.json`) and draw it. You\nreview the spec with the engineer, fix what the configs can't tell you, and present the\nresult. Everything runs locally and needs no install; no Damira API call is made.\n\n## Step 1: Choose the folder and check the inputs\n\nWork in `documents\u002F\u003Cid>\u002F`, where `\u003Cid>` is short and kebab-case, such as\n`documents\u002Fchi-core-topology\u002F`. The inputs are the files in `configs\u002F`: running-configs\n(IOS, IOS-XE, NX-OS, Junos `set` form) and saved `show cdp neighbors detail` or\n`show lldp neighbors detail` output, one file per device.\n\nConfigs alone give links only where two devices share a \u002F29 to \u002F31 subnet, plus BGP\nsessions. If there is no CDP\u002FLLDP output, say so and suggest the engineer saves\n`show cdp neighbors detail` (or LLDP) from each device into `configs\u002F`. Give the command;\ndon't run it on devices.\n\nNo configs at all, but the engineer describes the network or a source of truth such as\nNetBox is connected? Write `documents\u002F\u003Cid>\u002Ftopology.json` yourself following\n`references\u002Fdiagram-spec.md`, and skip to Step 4.\n\n## Step 2: Build the spec\n\n```bash\n~\u002F.damira\u002Fbin\u002Fdamira diagram build configs\u002F -o documents\u002F\u003Cid>\u002Ftopology.json\n```\n\nIt prints what it found, for example \"7 nodes (3 external), 8 links: 6 from CDP\u002FLLDP, 0\nfrom shared subnets, 1 BGP-only (dashed)\", plus a note for every device no CDP\u002FLLDP\noutput mentions.\n\n## Step 3: Review the links with the engineer\n\nRead `topology.json` and summarise it in a short table: each link's two ends with their\ninterfaces, and how it was found. Point out what is inferred rather than seen:\n- links with `source` `subnet` or `bgp` (no CDP\u002FLLDP behind them)\n- dashed `bgp` edges and `external` nodes\n- devices the notes say no neighbour output mentions\n\nAsk whether anything is missing or wrong. Apply the answers by editing the spec (see\n`references\u002Fdiagram-spec.md`): set `role`, `tier` or `zone`, add links with\n`\"source\": \"manual\"`, delete links that aren't real. Never invent a link or an interface\nthe engineer or the evidence didn't give you.\n\n## Step 4: Render\n\n```bash\n~\u002F.damira\u002Fbin\u002Fdamira diagram render documents\u002F\u003Cid>\u002Ftopology.json\n```\n\nThis writes `topology.svg`, `index.html`, `topology.mmd` and `topology.d2` next to the\nspec. The same spec always gives the same files.\n\nAdd `--pptx` if the engineer wants an editable slide (for a deck or a CAB). It uses\npython-pptx if present, otherwise `uv run --with python-pptx`. Exit code 4 means no slide\nwas written because neither is available; everything else is. Suggest installing uv.\n\n## Step 5: Present\n\n1. Give the paths: `topology.svg` for documents, `index.html` for viewing (the diagram\n   plus device and link tables; self-contained). Open it in Cursor's browser.\n2. Show the Mermaid inline in a ```mermaid block, so the engineer sees it in chat and can\n   paste it into a wiki or a ticket.\n3. **If this Cursor build can show a canvas**, build one from `topology.json`, not from\n   the SVG. Keep it local:\n   - a stats row: devices, links, external nodes, inferred (subnet or bgp) links\n   - the diagram, nodes by tier top to bottom, dashed for `bgp` edges and external nodes\n   - a link table: both ends, interfaces, subnet, source\n\n   No canvas available? The preview covers it. Don't mention the canvas.\n\nNeed a copy to put in a ticket or send outside the team? Render a redacted one; never\nshare the original preview:\n\n```bash\n~\u002F.damira\u002Fbin\u002Fdamira diagram render documents\u002F\u003Cid>\u002Ftopology.json \\\n  --redact --out-dir documents\u002F\u003Cid>\u002Fshare\n```\n\nHostnames, AS numbers, management IPs and subnets become tokens (HOST-1, IP-2, NET-1),\nthe same in every file. Show the user the redaction counts and ask them to check\n`documents\u002F\u003Cid>\u002Fshare\u002Findex.html` for anything left.\n\nWhen a MOP, change control or incident report in the same folder needs the diagram,\nreference `topology.svg` or paste the Mermaid into it.\n","# Topology diagrams\n\nThe Damira scripts parse the configs into a spec (`topology.json`) and draw it. You\nreview the spec with the engineer, fix what the configs can't tell you, and present the\nresult. Everything runs locally and needs no install; no Damira API call is made.\n\n## Step 1: Choose the folder and check the inputs\n\nWork in `documents\u002F\u003Cid>\u002F`, where `\u003Cid>` is short and kebab-case, such as\n`documents\u002Fchi-core-topology\u002F`. The inputs are the files in `configs\u002F`: running-configs\n(IOS, IOS-XE, NX-OS, Junos `set` form) and saved `show cdp neighbors detail` or\n`show lldp neighbors detail` output, one file per device.\n\nConfigs alone give links only where two devices share a \u002F29 to \u002F31 subnet, plus BGP\nsessions. If there is no CDP\u002FLLDP output, say so and suggest the engineer saves\n`show cdp neighbors detail` (or LLDP) from each device into `configs\u002F`. Give the command;\ndon't run it on devices.\n\nNo configs at all, but the engineer describes the network or a source of truth such as\nNetBox is connected? Write `documents\u002F\u003Cid>\u002Ftopology.json` yourself following\n`references\u002Fdiagram-spec.md`, and skip to Step 4.\n\n## Step 2: Build the spec\n\n```bash\n~\u002F.damira\u002Fbin\u002Fdamira diagram build configs\u002F -o documents\u002F\u003Cid>\u002Ftopology.json\n```\n\nIt prints what it found, for example \"7 nodes (3 external), 8 links: 6 from CDP\u002FLLDP, 0\nfrom shared subnets, 1 BGP-only (dashed)\", plus a note for every device no CDP\u002FLLDP\noutput mentions.\n\n## Step 3: Review the links with the engineer\n\nRead `topology.json` and summarise it in a short table: each link's two ends with their\ninterfaces, and how it was found. Point out what is inferred rather than seen:\n- links with `source` `subnet` or `bgp` (no CDP\u002FLLDP behind them)\n- dashed `bgp` edges and `external` nodes\n- devices the notes say no neighbour output mentions\n\nAsk whether anything is missing or wrong. Apply the answers by editing the spec (see\n`references\u002Fdiagram-spec.md`): set `role`, `tier` or `zone`, add links with\n`\"source\": \"manual\"`, delete links that aren't real. Never invent a link or an interface\nthe engineer or the evidence didn't give you.\n\n## Step 4: Render\n\n```bash\n~\u002F.damira\u002Fbin\u002Fdamira diagram render documents\u002F\u003Cid>\u002Ftopology.json\n```\n\nThis writes `topology.svg`, `index.html`, `topology.mmd` and `topology.d2` next to the\nspec. The same spec always gives the same files.\n\nAdd `--pptx` if the engineer wants an editable slide (for a deck or a CAB). It uses\npython-pptx if present, otherwise `uv run --with python-pptx`. Exit code 4 means no slide\nwas written because neither is available; everything else is. Suggest installing uv.\n\n## Step 5: Present\n\n1. Give the paths: `topology.svg` for documents, `index.html` for viewing (the diagram\n   plus device and link tables; self-contained). Open it in Cursor's browser.\n2. Show the Mermaid inline in a ```mermaid block, so the engineer sees it in chat and can\n   paste it into a wiki or a ticket.\n3. **If this Cursor build can show a canvas**, build one from `topology.json`, not from\n   the SVG. Keep it local:\n   - a stats row: devices, links, external nodes, inferred (subnet or bgp) links\n   - the diagram, nodes by tier top to bottom, dashed for `bgp` edges and external nodes\n   - a link table: both ends, interfaces, subnet, source\n\n   No canvas available? The preview covers it. Don't mention the canvas.\n\nNeed a copy to put in a ticket or send outside the team? Render a redacted one; never\nshare the original preview:\n\n```bash\n~\u002F.damira\u002Fbin\u002Fdamira diagram render documents\u002F\u003Cid>\u002Ftopology.json \\\n  --redact --out-dir documents\u002F\u003Cid>\u002Fshare\n```\n\nHostnames, AS numbers, management IPs and subnets become tokens (HOST-1, IP-2, NET-1),\nthe same in every file. Show the user the redaction counts and ask them to check\n`documents\u002F\u003Cid>\u002Fshare\u002Findex.html` for anything left.\n\nWhen a MOP, change control or incident report in the same folder needs the diagram,\nreference `topology.svg` or paste the Mermaid into it.\n",{"name":5,"description":7},"main","016916dbccc55b32762ccec3eac9030f8bacb249","damira-cursor\u002Fskills\u002Fgenerate-diagram","https:\u002F\u002Fgithub.com\u002Fciscoittech\u002Fdamira-plugins","https:\u002F\u002Fdamiraai.com","https:\u002F\u002Fgithub.com\u002Fciscoittech","I do crazy things with A.I","2026-11-02 11:12:12",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add ciscoittech\u002Fdamira-plugins --skill generate-diagram",{"tool":38,"command":39},"bunx","bunx skills add ciscoittech\u002Fdamira-plugins --skill generate-diagram",{"tool":41,"command":42},"pnpm","pnpm dlx skills add ciscoittech\u002Fdamira-plugins --skill generate-diagram","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fciscoittech\u002Fdamira-plugins\u002Fblob\u002Fmain\u002Fdamira-cursor\u002Fskills\u002Fgenerate-diagram\u002FSKILL.md",true,[46],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"references\u002Fdiagram-spec.md","REFERENCE","参考文档",3454,"https:\u002F\u002Fgithub.com\u002Fciscoittech\u002Fdamira-plugins\u002Fblob\u002Fmain\u002Fdamira-cursor\u002Fskills\u002Fgenerate-diagram\u002Freferences\u002Fdiagram-spec.md",[53,60,67,74,81,88],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":19},"01M7AGHRRQXXRQVG1W3GCF9YW7","upgrade-plan","Ask Damira to assess a version-to-version upgrade of a network platform and produce the MOP and change control. Use when the user names a product and a target release — \"IOS-XE 17.6.5 to 17.9.5\", \"CUCM 12.5 SU7 to 15\", \"PAN-OS 10.2 to 11.1\" — or asks what breaks, what the risk is, or how long a maintenance window needs to be. Covers CUCM, IOS-XE, IOS-XR, NX-OS, PAN-OS, FortiOS, Junos, ISE, ASA, WLC\u002FCatalyst 9800. Not for platform-to-platform migration (CUCM to Webex Calling, on-prem to cloud) and not for diagnosing a fault after an upgrade — use troubleshoot for that.","https:\u002F\u002Fgithub.com\u002Fciscoittech\u002Fdamira-plugins\u002Fblob\u002Fmain\u002Fdamira-cursor\u002Fskills\u002Fupgrade-plan\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M7AGHKWQX8XPBAFSZH7E4N1D","troubleshoot","Ask Damira to diagnose an active, in-progress network fault. Use when the user reports something broken right now — an outage, a flapping interface, a BGP or OSPF adjacency down, dropped or blackholed traffic, failed calls, users unable to connect — or pastes show\u002Flog output for analysis. Also fires on direct questions like \"why is BGP down\" or \"why is OSPF stuck in EXSTART\". Returns vendor-specific diagnosis with exact CLI commands. Do NOT use for \"how does X work\" protocol questions, for reviewing a config that is not currently broken (use config-audit), or for planning an upgrade (use upgrade-plan).","https:\u002F\u002Fgithub.com\u002Fciscoittech\u002Fdamira-plugins\u002Fblob\u002Fmain\u002Fdamira-cursor\u002Fskills\u002Ftroubleshoot\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M7AGHEG8SYWJ12TQRC04XXWZ","source-of-truth-change","Turn intended state in the engineer's source of truth (NetBox or Nautobot) into a validated change, then hand it to the automation they already run — an Ansible Automation Platform job in check mode, a pyATS\u002FGenie before-and-after diff, or a Terraform plan. Use when the user asks to make a change \"from NetBox\" or \"from Nautobot\", to push what the source of truth says, to bring devices in line with intended state, or to run a validated playbook through AAP or pyATS. Damira never applies the change; the engineer does. For a playbook with no source of truth use generate-playbook, for Terraform alone use generate-terraform, and for an active outage use troubleshoot.","https:\u002F\u002Fgithub.com\u002Fciscoittech\u002Fdamira-plugins\u002Fblob\u002Fmain\u002Fdamira-cursor\u002Fskills\u002Fsource-of-truth-change\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M7AGH9A7RS5CC5H5NSNC04K3","lab-test-change","Test a network change in a throwaway ContainerLab lab before it goes near production — deploy the lab, apply the playbook or script, run show-command or pyATS\u002FGenie checks, report pass\u002Ffail, and always destroy the lab. Use when the user says \"test this in a lab first\", \"prove this change before the window\", \"dry-run this playbook against a lab\", or wants evidence a change works before a CAB. Needs docker and containerlab on the engineer's machine; without them it validates only and says so. To only build a lab, use generate-lab; to write the change, use generate-playbook, generate-automation or generate-terraform.","https:\u002F\u002Fgithub.com\u002Fciscoittech\u002Fdamira-plugins\u002Fblob\u002Fmain\u002Fdamira-cursor\u002Fskills\u002Flab-test-change\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M7AGH4SFXKQA552XNMB0M4QT","generate-workbook","Build an Excel workbook (.xlsx) for a network procedure — a migration, platform migration, security audit, change control, or incident-response workbook — grounded in Damira evidence, with an HTML preview. Use when the user asks for a spreadsheet, workbook, tracker, or Excel version of a migration plan, cutover, audit findings, change record, or incident timeline. For a version-to-version upgrade, use upgrade-plan (it offers the workbook itself). Not for diagnosing an active fault — use troubleshoot.","https:\u002F\u002Fgithub.com\u002Fciscoittech\u002Fdamira-plugins\u002Fblob\u002Fmain\u002Fdamira-cursor\u002Fskills\u002Fgenerate-workbook\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"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},"01M7AGH0RPM7QTN4094HYS023Z","generate-tests","Write network tests — pyATS\u002FGenie learn, change, learn, diff jobs that prove a change did what it should and nothing else, and pytest tests for automation scripts — then validate them locally. Use when the user asks for pyATS, Genie, AEtest, a testbed file, pre\u002Fpost change verification, state snapshots, or unit tests for a Nornir\u002FNetmiko script. For the change itself use generate-playbook, generate-automation or generate-terraform.","https:\u002F\u002Fgithub.com\u002Fciscoittech\u002Fdamira-plugins\u002Fblob\u002Fmain\u002Fdamira-cursor\u002Fskills\u002Fgenerate-tests\u002FSKILL.md",[],[]]