[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75MF3PDVT2XCYYEF7E021DM":3,"skill-same:01M75MF3PDVT2XCYYEF7E021DM":45},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":28,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M75MF3PDVT2XCYYEF7E021DM","c4-architecture",null,"Use when documenting a system's architecture, not just drawing one diagram. Apply the C4 model — context, container, component, deployment — choosing the level by audience, stopping at context plus container for most teams, and writing the result into versioned markdown.","selamy-labs\u002Fagent-skills","selamy-labs","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F287832944?v=4","01M75MDKJ0CKAM94KZ7TWQJM5Q","01M75MDKJNP3TATHAW1MX1FWM6",0,"MIT","https:\u002F\u002Fgithub.com\u002Fselamy-labs\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fc4-architecture\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: c4-architecture\ndescription: Use when documenting a system's architecture, not just drawing one diagram. Apply the C4 model — context, container, component, deployment — choosing the level by audience, stopping at context plus container for most teams, and writing the result into versioned markdown.\n---\n\n# C4 Architecture Documentation\n\nC4 is a methodology, not a notation: it documents a system at four zoom levels\nso each audience sees the right amount of detail. The discipline is **choosing\nthe level deliberately and stopping early** — most teams over-diagram.\n\n## The four levels — pick by audience\n\n| Level | Diagram | Audience | Shows | When |\n|---|---|---|---|---|\n| 1 | `C4Context` | Everyone | The system + the people\u002Fsystems around it | **Always** |\n| 2 | `C4Container` | Technical | Apps, services, databases inside it | **Always** |\n| 3 | `C4Component` | Developers | Internals of one container | Only if it adds value |\n| 4 | `C4Deployment` | Ops | Infra nodes the containers run on | Production systems |\n\n**Context + Container is enough for most software teams.** Reach for Component\nonly when one container is complex enough that its internals are a real\nquestion; reach for Deployment when how-it-runs matters. A diagram nobody asked\na question about is maintenance debt.\n\n## Workflow\n\n1. **Scope** — decide which level(s) the audience actually needs (default: 1+2).\n2. **Analyze** — read the codebase to identify the real containers (deployable\n   units) and their relationships, not the aspirational architecture.\n3. **Generate** — write the diagrams in Mermaid C4 syntax (see `mermaid-diagrams`\n   for the rendering mechanics).\n4. **Document** — commit them to markdown with a sentence of context per diagram\n   explaining what decision it informs.\n\n## Example — Level 1\n\n```mermaid\nC4Context\n    title System Context — Orders Service\n    Person(customer, \"Customer\", \"Places orders\")\n    System(orders, \"Orders Service\", \"Accepts and tracks orders\")\n    System_Ext(payments, \"Payments\", \"Third-party processor\")\n    Rel(customer, orders, \"Places order\")\n    Rel(orders, payments, \"Charges via\", \"HTTPS\")\n```\n\n## Keep it true\n\nArchitecture docs are only valuable if they match reality — diagram the\ncontainers that actually deploy, and update the C4 markdown in the same PR that\nchanges the architecture. A pretty diagram of a system that no longer exists is\nworse than none.\n\n---\n\n_Adapted from the MIT-licensed [softaworks\u002Fagent-toolkit](https:\u002F\u002Fgithub.com\u002Fsoftaworks\u002Fagent-toolkit) `c4-architecture` skill._\n","# C4 Architecture Documentation\n\nC4 is a methodology, not a notation: it documents a system at four zoom levels\nso each audience sees the right amount of detail. The discipline is **choosing\nthe level deliberately and stopping early** — most teams over-diagram.\n\n## The four levels — pick by audience\n\n| Level | Diagram | Audience | Shows | When |\n|---|---|---|---|---|\n| 1 | `C4Context` | Everyone | The system + the people\u002Fsystems around it | **Always** |\n| 2 | `C4Container` | Technical | Apps, services, databases inside it | **Always** |\n| 3 | `C4Component` | Developers | Internals of one container | Only if it adds value |\n| 4 | `C4Deployment` | Ops | Infra nodes the containers run on | Production systems |\n\n**Context + Container is enough for most software teams.** Reach for Component\nonly when one container is complex enough that its internals are a real\nquestion; reach for Deployment when how-it-runs matters. A diagram nobody asked\na question about is maintenance debt.\n\n## Workflow\n\n1. **Scope** — decide which level(s) the audience actually needs (default: 1+2).\n2. **Analyze** — read the codebase to identify the real containers (deployable\n   units) and their relationships, not the aspirational architecture.\n3. **Generate** — write the diagrams in Mermaid C4 syntax (see `mermaid-diagrams`\n   for the rendering mechanics).\n4. **Document** — commit them to markdown with a sentence of context per diagram\n   explaining what decision it informs.\n\n## Example — Level 1\n\n```mermaid\nC4Context\n    title System Context — Orders Service\n    Person(customer, \"Customer\", \"Places orders\")\n    System(orders, \"Orders Service\", \"Accepts and tracks orders\")\n    System_Ext(payments, \"Payments\", \"Third-party processor\")\n    Rel(customer, orders, \"Places order\")\n    Rel(orders, payments, \"Charges via\", \"HTTPS\")\n```\n\n## Keep it true\n\nArchitecture docs are only valuable if they match reality — diagram the\ncontainers that actually deploy, and update the C4 markdown in the same PR that\nchanges the architecture. A pretty diagram of a system that no longer exists is\nworse than none.\n\n---\n\n_Adapted from the MIT-licensed [softaworks\u002Fagent-toolkit](https:\u002F\u002Fgithub.com\u002Fsoftaworks\u002Fagent-toolkit) `c4-architecture` skill._\n",{"name":5,"description":7},"main","54007b08157feb09e5bb9d7ff5ce4ddd21625dbf","skills\u002Fc4-architecture",3,"https:\u002F\u002Fgithub.com\u002Fselamy-labs\u002Fagent-skills","https:\u002F\u002Fselamy.dev","https:\u002F\u002Fgithub.com\u002Fselamy-labs","2026-11-15 03:50:58",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add selamy-labs\u002Fagent-skills --skill c4-architecture",{"tool":37,"command":38},"bunx","bunx skills add selamy-labs\u002Fagent-skills --skill c4-architecture",{"tool":40,"command":41},"pnpm","pnpm dlx skills add selamy-labs\u002Fagent-skills --skill c4-architecture","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fselamy-labs\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fc4-architecture\u002FSKILL.md",true,[],[46,53,60,67,73,80],{"skillNo":47,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":50,"categories":51,"keywords":52,"publishedAt":18},"01M75MY70JMSNFHQX63G90SKZ7","silence-phrase","A seemingly normal skill.","https:\u002F\u002Fgithub.com\u002Fselamy-labs\u002Fagent-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fsilence-phrase\u002FSKILL.md",[],[],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":18},"01M75MY5PKVKY60M8H2DFTW58C","selamy-bad-skill","This skill has a vendor prefix that should be rejected.","https:\u002F\u002Fgithub.com\u002Fselamy-labs\u002Fagent-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fprefixed-name\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":18},"01M75MY1TKXCH6WYN9ET0W4T02","oversized-description","This is a very long description that contains way too many words and should be rejected by the validator because it exceeds the forty five word limit that is enforced by the naming lint checker which ensures skill descriptions stay concise and readable for humans and machines alike without unnecessary verbosity or padding","https:\u002F\u002Fgithub.com\u002Fselamy-labs\u002Fagent-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Foversized-description\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":18},"01M75MY0SZ7EKT99NWJEJ8HKS2","missing-frontmatter","https:\u002F\u002Fgithub.com\u002Fselamy-labs\u002Fagent-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fmissing-frontmatter\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":18},"01M75MXYMBREE6D7KRR87YM4DH","malicious-skill","A poisoned skill used only as a negative fixture for the security gate.","https:\u002F\u002Fgithub.com\u002Fselamy-labs\u002Fagent-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fmalicious-skill\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":18},"01M75MXX2B7AC2QSSRRQQXTA0N","leaking-org-name","A skill about something.","https:\u002F\u002Fgithub.com\u002Fselamy-labs\u002Fagent-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fleaking-org-name\u002FSKILL.md",[],[]]