[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M76W24BRG173NXGJEDCSYCQN":3,"skill-same:01M76W24BRG173NXGJEDCSYCQN":78},{"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":33,"commitSha":34,"skillDirectory":35,"forksCount":14,"repositoryHtmlUrl":36,"repositoryHomepageUrl":6,"ownerHtmlUrl":37,"ownerBlogUrl":6,"ownerDescription":38,"updatedAt":39,"install":40,"resources":53},"01M76W24BRG173NXGJEDCSYCQN","hexagonal-architecture",null,"Use when isolating domain logic from frameworks, UI, and databases through ports and adapters. Do not use when the domain is trivial or the project is a thin framework wrapper.","HarleyBartles\u002Fagent-asset-marketplace","HarleyBartles","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F32537371?v=4","01M7590KP2F50J1QPVEK7V7071","Harley Bartles","01M7590KQ4B141665T2GDDCWQX",0,"MIT","https:\u002F\u002Fgithub.com\u002FHarleyBartles\u002Fagent-asset-marketplace\u002Fblob\u002Fmain\u002Fskills\u002Fhexagonal-architecture\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: hexagonal-architecture\ndescription: Use when isolating domain logic from frameworks, UI, and databases through ports and adapters. Do not use when the domain is trivial or the project is a thin framework wrapper.\nmetadata:\n  source-id: hexagonal-architecture\n  source-path: skills\u002Fhexagonal-architecture\u002FSKILL.md\n  provenance-name: Hexagonal Architecture first-party skill\n  source-category: first_party\n  status: active\n  owner: Harley Bartles\n  use_when:\n    - isolating domain logic from frameworks, UI, and databases through ports and adapters\n  do_not_use_when:\n    - the domain is trivial or the project is a thin framework wrapper\nlicense: MIT\n---\n\n# Hexagonal Architecture\n\n## Overview\n\nPlace domain logic at the center of the application and connect it to the outside world through explicit ports and adapters, so the core remains framework-agnostic.\n\n## When to Use\n\n- The application must stay independent of databases, web frameworks, messaging systems, and external APIs.\n- You need to test business rules with fake or in-memory adapters instead of real infrastructure.\n- You want to swap a primary actor such as a UI, CLI, or test harness, or a secondary actor such as a database or service, without touching domain code.\n- Do not use when the domain is trivial or the project is a thin framework wrapper.\n\n## Core Pattern\n\nDefine **ports** as interfaces the domain needs to interact with the outside world. Implement each port with one or more **adapters**:\n\n- **Primary (driving) adapters** call the domain: REST controllers, CLI handlers, event consumers, and test fixtures.\n- **Secondary (driven) adapters** are called by the domain: repositories, notification services, and external APIs.\n\nThe domain declares what it needs; adapters satisfy those needs. Dependencies cross the port boundary only in the direction that leaves the domain untouched.\n\n## Common Mistakes\n\n- Building adapters that bypass the ports and call domain objects directly. Fix by routing all outside interaction through the declared port interfaces.\n- Allowing frameworks to leak into application or domain code. Keep framework-specific annotations, SDK types, and configuration in adapter implementations.\n- Confusing hexagonal architecture with clean or onion architecture. All three isolate the domain; hexagonal emphasizes ports and adapters as the concrete integration mechanism, while clean adds a layered dependency rule and onion uses concentric layers with dependency inversion.\n","# Hexagonal Architecture\n\n## Overview\n\nPlace domain logic at the center of the application and connect it to the outside world through explicit ports and adapters, so the core remains framework-agnostic.\n\n## When to Use\n\n- The application must stay independent of databases, web frameworks, messaging systems, and external APIs.\n- You need to test business rules with fake or in-memory adapters instead of real infrastructure.\n- You want to swap a primary actor such as a UI, CLI, or test harness, or a secondary actor such as a database or service, without touching domain code.\n- Do not use when the domain is trivial or the project is a thin framework wrapper.\n\n## Core Pattern\n\nDefine **ports** as interfaces the domain needs to interact with the outside world. Implement each port with one or more **adapters**:\n\n- **Primary (driving) adapters** call the domain: REST controllers, CLI handlers, event consumers, and test fixtures.\n- **Secondary (driven) adapters** are called by the domain: repositories, notification services, and external APIs.\n\nThe domain declares what it needs; adapters satisfy those needs. Dependencies cross the port boundary only in the direction that leaves the domain untouched.\n\n## Common Mistakes\n\n- Building adapters that bypass the ports and call domain objects directly. Fix by routing all outside interaction through the declared port interfaces.\n- Allowing frameworks to leak into application or domain code. Keep framework-specific annotations, SDK types, and configuration in adapter implementations.\n- Confusing hexagonal architecture with clean or onion architecture. All three isolate the domain; hexagonal emphasizes ports and adapters as the concrete integration mechanism, while clean adds a layered dependency rule and onion uses concentric layers with dependency inversion.\n",{"name":5,"license":15,"metadata":24,"description":7},{"owner":12,"status":25,"use_when":26,"source-id":5,"source-path":28,"do_not_use_when":29,"provenance-name":31,"source-category":32},"active",[27],"isolating domain logic from frameworks, UI, and databases through ports and adapters","skills\u002Fhexagonal-architecture\u002FSKILL.md",[30],"the domain is trivial or the project is a thin framework wrapper","Hexagonal Architecture first-party skill","first_party","main","61dfbcb84501e21a9904b55b207485abcb0b2ffa","skills\u002Fhexagonal-architecture","https:\u002F\u002Fgithub.com\u002FHarleyBartles\u002Fagent-asset-marketplace","https:\u002F\u002Fgithub.com\u002FHarleyBartles","Full Stack Software Engineer","2026-10-08 23:51:53",{"source":8,"skillName":5,"commands":41,"prompt":51,"zipAvailable":52},[42,45,48],{"tool":43,"command":44},"npx","npx skills add HarleyBartles\u002Fagent-asset-marketplace --skill hexagonal-architecture",{"tool":46,"command":47},"bunx","bunx skills add HarleyBartles\u002Fagent-asset-marketplace --skill hexagonal-architecture",{"tool":49,"command":50},"pnpm","pnpm dlx skills add HarleyBartles\u002Fagent-asset-marketplace --skill hexagonal-architecture","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FHarleyBartles\u002Fagent-asset-marketplace\u002Fblob\u002Fmain\u002Fskills\u002Fhexagonal-architecture\u002FSKILL.md",true,[54,60,66,70,74],{"path":55,"resourceType":56,"resourceTypeDesc":57,"sizeBytes":58,"sourceHtmlUrl":59},"agents\u002Fopenai.yaml","REFERENCE","参考文档",601,"https:\u002F\u002Fgithub.com\u002FHarleyBartles\u002Fagent-asset-marketplace\u002Fblob\u002Fmain\u002Fskills\u002Fhexagonal-architecture\u002Fagents\u002Fopenai.yaml",{"path":61,"resourceType":62,"resourceTypeDesc":63,"sizeBytes":64,"sourceHtmlUrl":65},"assets\u002Fauthority\u002Fauthority.yaml","ASSET","资产文件",997,"https:\u002F\u002Fgithub.com\u002FHarleyBartles\u002Fagent-asset-marketplace\u002Fblob\u002Fmain\u002Fskills\u002Fhexagonal-architecture\u002Fassets\u002Fauthority\u002Fauthority.yaml",{"path":67,"resourceType":62,"resourceTypeDesc":63,"sizeBytes":68,"sourceHtmlUrl":69},"assets\u002Fauthority\u002FCITATIONS.md",1122,"https:\u002F\u002Fgithub.com\u002FHarleyBartles\u002Fagent-asset-marketplace\u002Fblob\u002Fmain\u002Fskills\u002Fhexagonal-architecture\u002Fassets\u002Fauthority\u002FCITATIONS.md",{"path":71,"resourceType":62,"resourceTypeDesc":63,"sizeBytes":72,"sourceHtmlUrl":73},"assets\u002Fauthority\u002Fsource-map.yaml",418,"https:\u002F\u002Fgithub.com\u002FHarleyBartles\u002Fagent-asset-marketplace\u002Fblob\u002Fmain\u002Fskills\u002Fhexagonal-architecture\u002Fassets\u002Fauthority\u002Fsource-map.yaml",{"path":75,"resourceType":56,"resourceTypeDesc":57,"sizeBytes":76,"sourceHtmlUrl":77},"references\u002Foperational-guidance.md",1771,"https:\u002F\u002Fgithub.com\u002FHarleyBartles\u002Fagent-asset-marketplace\u002Fblob\u002Fmain\u002Fskills\u002Fhexagonal-architecture\u002Freferences\u002Foperational-guidance.md",[79,86,93,100,106,113],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M76WCC1A6JQP15DX8HPZ5C5J","writing","Use when drafting, revising, or reviewing prose for human readers and clarity, an authorised voice, or reader-fatigue concerns may interact.","https:\u002F\u002Fgithub.com\u002FHarleyBartles\u002Fagent-asset-marketplace\u002Fblob\u002Fmain\u002Fskills\u002Fwriting\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M76WC4DSHYD15E8BDPQ433XF","writing-with-clarity","Use when drafting, revising, or reviewing prose intended for human readers, including documentation, README files, reports, explanations, UI copy, errors, comments, commit messages, and pull request text.","https:\u002F\u002Fgithub.com\u002FHarleyBartles\u002Fagent-asset-marketplace\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-with-clarity\u002FSKILL.md",[],[],{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":19},"01M76WBZ9MYM991K6QKY1DN4MK","writing-style","Use when revising or reviewing human-facing prose against an authorised voice card or a contextual reader-fatigue profile.","https:\u002F\u002Fgithub.com\u002FHarleyBartles\u002Fagent-asset-marketplace\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-style\u002FSKILL.md",[],[],{"skillNo":101,"name":102,"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":103,"categories":104,"keywords":105,"publishedAt":19},"01M76WBVKC1Y158TTZJR400A4J","skill","https:\u002F\u002Fgithub.com\u002FHarleyBartles\u002Fagent-asset-marketplace\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-skills\u002Ftemplates\u002Fskill\u002FSKILL.md",[],[],{"skillNo":107,"name":108,"nameZh":6,"description":109,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":110,"categories":111,"keywords":112,"publishedAt":19},"01M76WBFD4D1XY20075H00AGYK","writing-skills","Use when creating new skills, editing existing skills, or verifying skills work before deployment.","https:\u002F\u002Fgithub.com\u002FHarleyBartles\u002Fagent-asset-marketplace\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-skills\u002FSKILL.md",[],[],{"skillNo":114,"name":115,"nameZh":6,"description":116,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":117,"categories":118,"keywords":119,"publishedAt":19},"01M76WB8S7XZZFTFFCFYW1J9CW","writing-roadmaps","Use when a goal is too large for one writing-plans plan and requires a sequenced roadmap of consecutive plans.","https:\u002F\u002Fgithub.com\u002FHarleyBartles\u002Fagent-asset-marketplace\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-roadmaps\u002FSKILL.md",[],[]]