[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6P3H4K7NPAX8CZKSHJEW5MR":3,"skill-same:01M6P3H4K7NPAX8CZKSHJEW5MR":71},{"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":22,"publishedAt":43,"linkOnly":44,"markdownContent":45,"markdownBody":46,"frontMatter":47,"refName":35,"commitSha":52,"skillDirectory":53,"forksCount":13,"repositoryHtmlUrl":54,"repositoryHomepageUrl":6,"ownerHtmlUrl":55,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":56,"install":57,"resources":70},"01M6P3H4K7NPAX8CZKSHJEW5MR","frontend-architecture",null,"A portable, framework-agnostic architecture style for any React or React Native frontend. Organizes apps into feature modules with page\u002Fscreen directories, a strict server-state vs UI-state split, barrel-only cross-module imports, co-located styles, and clear component-promotion rules.","duc-duy-1612\u002FOnline-Delivery-Systems-Web","duc-duy-1612","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F192231384?v=4","01M6NSDKQQDKVTHZ8DZMZ1VYY6","01M6NSDKW8DDVTQHBT1HBDDJPT",0,"MIT","https:\u002F\u002Fgithub.com\u002Fduc-duy-1612\u002FOnline-Delivery-Systems-Web\u002Fblob\u002Fmain\u002F.agents\u002Fskills_archive\u002Ffrontend-architecture\u002FSKILL.md",[17],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000009","前端开发","SCENARIO","使用场景",[23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42],"architecture","frontend architecture","frontend","community","imports","directories","co","native","screen","apps","critical","wed","main","modules","only","react native","server","ui","component","react","2026-11-10 10:12:30",false,"---\nname: frontend-architecture\ndescription: \"A portable, framework-agnostic architecture style for any React or React Native frontend. Organizes apps into feature modules with page\u002Fscreen directories, a strict server-state vs UI-state split, barrel-only cross-module imports, co-located styles, and clear component-promotion rules.\"\nrisk: critical\nsource: https:\u002F\u002Fgithub.com\u002Fstareezy-1\u002Ffrontend-architecture-skill\u002Ftree\u002Fmain\u002Fskills\u002Ffrontend-architecture\nsource_repo: stareezy-1\u002Ffrontend-architecture-skill\nsource_type: community\ndate_added: 2026-07-01\nlicense: MIT\nlicense_source: https:\u002F\u002Fgithub.com\u002Fstareezy-1\u002Ffrontend-architecture-skill\u002Fblob\u002Fmain\u002FLICENSE\n---\n\n# Frontend Architecture (portable, module-based)\n## When to Use\n\nUse this skill when you need a portable, framework-agnostic architecture style for any React or React Native frontend. Organizes apps into feature modules with page\u002Fscreen directories, a strict server-state vs UI-state split, barrel-only cross-module imports, co-located styles, and clear component-promotion rules....\n\n\n> Portable skill — readable by Claude Code, OpenCode, Codex, Cursor, Windsurf, and others.\n> This skill describes a **structure and a set of rules**, not a component library, a state library, or a visual style.\n> It is deliberately global: the same module\u002Fpage\u002Fstate model maps onto\n> **Next.js (App Router)**, **React + Vite (SPA)**, **Remix**, and **Expo \u002F React Native**, and it works\n> with **any** state-management and styling stack.\n\nThe goal: a codebase where any contributor can instantly answer three questions —\n**\"where does this code live?\"**, **\"what is allowed to import what?\"**, and **\"is this server state or UI state?\"** —\nwithout asking anyone. The structure makes the answers obvious.\n\n---\n\n## 0. The five core ideas\n\n1. **Feature modules own their world.** Each feature is a self-contained `modules\u002F{feature}\u002F` folder with its own pages, components, hooks, state, types, and a single public barrel.\n2. **Pages\u002Fscreens are directories, not files.** A route is a folder that co-locates its component, its styles, and the components\u002Fhooks used only by it.\n3. **State is split by origin.** Server data lives in a query\u002Fcache layer. UI\u002Fclient state lives in a store. They never overlap — regardless of which libraries you pick.\n4. **Imports cross boundaries only through barrels.** Reaching into another module's internals is forbidden; you import from `@\u002Fmodules\u002F{feature}` and nothing deeper.\n5. **Code is promoted, not pre-placed.** It starts as local as possible and moves outward only when a second consumer appears.\n\nEverything below is the mechanical application of these five ideas. None of it is tied to a specific library — pick your stack in Sections 4 and 6.\n\n---\n\n## 1. Directory layout\n\nThe shape is identical across frameworks; only the routing layer on top differs (see Section 7).\n\n```\nsrc\u002F\n├── app\u002F or routes\u002F or navigation\u002F   ← framework routing layer (thin — see §7)\n├── modules\u002F                         ← feature modules (the heart of the app)\n│   └── {feature}\u002F\n│       ├── index.ts                 ← PUBLIC BARREL — the only cross-module entry point\n│       ├── README.md                ← what this module owns, its routes, its data deps\n│       ├── components\u002F              ← components reused by 2+ pages IN THIS MODULE\n│       ├── pages\u002F                   ← page\u002Fscreen directories (one per route)\n│       │   └── {page}\u002F\n│       │       ├── {page}.tsx               ← the page\u002Fscreen component\n│       │       ├── {page}.styles.ts         ← ALL styling for this page\n│       │       ├── index.ts                 ← re-exports the page component\n│       │       ├── components\u002F              ← components used ONLY by this page\n│       │       ├── hooks\u002F                   ← hooks used ONLY by this page\n│       │       ├── constants\u002F\n│       │       └── README.md                ← route, params, permissions, data deps\n│       ├── hooks\u002F                   ← data hooks (query\u002Fmutation) + module hooks\n│       ├── stores\u002F                  ← UI\u002Fclient state store(s) — never server data\n│       ├── services\u002F                ← data-access (API calls) for this feature\n│       ├── utils\u002F                   ← pure module utilities (co-located *.test.ts)\n│       ├── constants\u002F\n│       └── types\u002F                   ← module request\u002Fresponse + view-model types\n└── shared\u002F                          ← cross-module building blocks\n    ├── components\u002F                  ← components used by 2+ MODULES\n    ├── hooks\u002F                       ← cross-cutting hooks\n    ├── api-client\u002F                  ← one typed client; the only place that talks to the network\n    ├── store\u002F                       ← root store wiring (if your state lib needs one — see §4)\n    ├── utils\u002F                       ← formatters, cn()\u002Fclsx, helpers\n    ├── constants\u002F\n    └── types\u002F\n```\n\nEvery folder that can be empty at scaffold time keeps a `.gitkeep` so the structure is visible from day one.\n\n---\n\n## 2. Feature modules\n\nA module is a vertical slice of the product (e.g. `auth`, `billing`, `dashboard`, `settings`). It contains everything that feature needs and exposes a deliberately small surface.\n\n### 2.1 The barrel (`index.ts`) is the contract\n\n`modules\u002F{feature}\u002Findex.ts` is the **only** thing other modules and the routing layer may import from. It re-exports:\n\n- Page\u002Fscreen components the router mounts.\n- Data hooks other features legitimately need.\n- The store hook\u002Fslice and its public types.\n- Shared constants \u002F types other features depend on.\n\n```ts\n\u002F\u002F CORRECT — consume the public surface\nimport { InvoiceListPage, useInvoiceList } from \"@\u002Fmodules\u002Finvoice\";\n\n\u002F\u002F WRONG — reaching into internals couples you to private structure\nimport { InvoiceListPage } from \"@\u002Fmodules\u002Finvoice\u002Fpages\u002Finvoice-list\u002Finvoice-list\";\n```\n\nKeep the barrel curated. If something isn't exported, it's private by design. Group exports with short comments (pages, hooks, store, types) — future readers use the barrel as the module's API docs.\n\n### 2.2 One module = one bounded context\n\nDon't create `utils` modules or `components` modules. Modules map to product capabilities, not to technical layers. Technical building blocks live in `shared\u002F`.\n\n### 2.3 Module README\n\nEach module's `README.md` states: what it owns, which routes render its pages, its data dependencies (which endpoints\u002Fhooks), and any cross-module rules. This is the first thing a new contributor reads.\n\n---\n\n## 3. Pages\u002Fscreens as directories\n\nA page is a route the router mounts (a \"screen\" in React Native). It is **always a folder**, never a loose file — even when it starts as a single component. This keeps growth in place: when the page needs a sub-component or a hook, there is already a home for it.\n\n```\npages\u002F{page}\u002F\n├── {page}.tsx          ← the page\u002Fscreen component\n├── {page}.styles.ts    ← every style for this page (no inline styles — see §5)\n├── index.ts            ← export { PageComponent } from \".\u002F{page}\"\n├── components\u002F         ← used ONLY by this page\n├── hooks\u002F              ← used ONLY by this page\n├── constants\u002F\n└── README.md           ← route, params, permissions, data deps\n```\n\nThe page README is short and high-signal: route path, expected params, required permissions\u002Fauth, and the hooks it depends on. It is the contract between the page and the rest of the app.\n\n**Why folders from the start:** a page that begins as one file inevitably grows a sub-row component, a derived-totals hook, a styles file. If the page is a file, those land in arbitrary places. If the page is a folder, they have an obvious home and the diff stays readable.\n\n---\n\n## 4. State: split by origin (non-negotiable, library-agnostic)\n\nTwo kinds of state, two homes. Mixing them is the most common architectural failure this skill exists to prevent. **The split is mandatory; the libraries are your choice.**\n\n| State kind            | Examples                                                                          | Lives in                                                                                |\n| --------------------- | --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |\n| **Server state**      | fetched entities, lists, aggregates — anything the API owns                       | a **query\u002Fcache layer** (e.g. TanStack Query, RTK Query, SWR, Apollo)                   |\n| **UI \u002F client state** | open dialogs, table filters\u002Fsort, wizard step, draft being typed, preview toggles | a **client store** (e.g. Zustand, Redux Toolkit, MobX, Jotai, Valtio, or React Context) |\n\n### 4.1 Hard rules (independent of library)\n\n- **Never mirror server responses into the client store.** No copying fetched entities into Zustand\u002FRedux\u002FMobX. The query\u002Fcache layer is the single source of truth for server data.\n- **Never fetch inside components.** Components read server data from a data hook and UI state from a store selector. They don't call the network client directly.\n- **Never drive continuous values through re-render state.** Scroll progress, pointer position, drag offset — use refs \u002F animation values, not render state (it re-renders the tree every frame).\n- **One store boundary per module.** Whatever library you use, give each module one cohesive store unit (a Zustand hook, a Redux slice, a MobX class, a Jotai atom group) accessed via the module barrel. Components subscribe to the smallest slice they need to avoid needless re-renders.\n\n### 4.2 Choosing a client-state library — same shape, different syntax\n\nPick one per project and stay consistent. Each maps onto \"one store unit per module\" cleanly. Note the **`I` interface-naming convention**: state interfaces are prefixed with `I` (e.g. `IFeatureUiState`).\n\n**Zustand** — `modules\u002F{feature}\u002Fstores\u002F{feature}.store.ts`\n\n```ts\nimport { create } from \"zustand\";\n\nexport interface IFeatureUiState {\n  isPreviewOpen: boolean;\n  filter: string;\n  togglePreview: () => void;\n  setFilter: (filter: string) => void;\n  reset: () => void;\n}\n\nconst INITIAL_STATE = { isPreviewOpen: false, filter: \"\" } as const;\n\nexport const useFeatureUiStore = create\u003CIFeatureUiState>()((set) => ({\n  ...INITIAL_STATE,\n  togglePreview: () => set((s) => ({ isPreviewOpen: !s.isPreviewOpen })),\n  setFilter: (filter) => set({ filter }),\n  reset: () => set({ ...INITIAL_STATE }),\n}));\n```\n\n**Redux Toolkit** — `modules\u002F{feature}\u002Fstores\u002F{feature}.slice.ts` (registered in `shared\u002Fstore\u002F`)\n\n```ts\nimport { createSlice, type PayloadAction } from \"@reduxjs\u002Ftoolkit\";\n\nexport interface IFeatureUiState {\n  isPreviewOpen: boolean;\n  filter: string;\n}\n\nconst initialState: IFeatureUiState = { isPreviewOpen: false, filter: \"\" };\n\nexport const featureUiSlice = createSlice({\n  name: \"featureUi\",\n  initialState,\n  reducers: {\n    togglePreview: (s) => {\n      s.isPreviewOpen = !s.isPreviewOpen;\n    },\n    setFilter: (s, action: PayloadAction\u003Cstring>) => {\n      s.filter = action.payload;\n    },\n    reset: () => initialState,\n  },\n});\n```\n\n**MobX** — `modules\u002F{feature}\u002Fstores\u002F{feature}.store.ts`\n\n```ts\nimport { makeAutoObservable } from \"mobx\";\n\nexport interface IFeatureUiState {\n  isPreviewOpen: boolean;\n  filter: string;\n}\n\nexport class FeatureUiStore implements IFeatureUiState {\n  isPreviewOpen = false;\n  filter = \"\";\n  constructor() {\n    makeAutoObservable(this);\n  }\n  togglePreview = () => {\n    this.isPreviewOpen = !this.isPreviewOpen;\n  };\n  setFilter = (filter: string) => {\n    this.filter = filter;\n  };\n  reset = () => {\n    this.isPreviewOpen = false;\n    this.filter = \"\";\n  };\n}\n```\n\n**Jotai** — `modules\u002F{feature}\u002Fstores\u002F{feature}.atoms.ts`\n\n```ts\nimport { atom } from \"jotai\";\nexport const isPreviewOpenAtom = atom(false);\nexport const filterAtom = atom(\"\");\n```\n\n> Whichever you choose, keep the rules in §4.1 constant. The skill cares that server and UI state are separated and that each module owns one store unit — not which library draws the box.\n\n### 4.3 Data layer (server state)\n\nAll network access goes through **one typed client** in `shared\u002Fapi-client\u002F`. Modules wrap it in query\u002Fmutation hooks and a **key factory** so caches and invalidation stay consistent.\n\n```ts\n\u002F\u002F modules\u002Finvoice\u002Fhooks\u002FinvoiceKeys.ts — hierarchical key factory (TanStack Query style)\nexport const invoiceKeys = {\n  all: [\"invoices\"] as const,\n  lists: () => [...invoiceKeys.all, \"list\"] as const,\n  list: (params: IListParams) => [...invoiceKeys.lists(), params] as const,\n  details: () => [...invoiceKeys.all, \"detail\"] as const,\n  detail: (id: string) => [...invoiceKeys.details(), id] as const,\n} as const;\n```\n\nInvalidating `lists()` refreshes every filtered page; `detail(id)` targets one entity. (RTK Query\u002FSWR\u002FApollo express the same idea with tags\u002Fkeys.) Components never write raw `fetch()` — they call `useInvoiceList()` \u002F `useCreateInvoice()`.\n\n---\n\n## 5. Styling: co-located, no inline styles (styling-library agnostic)\n\nKeep styling out of JSX and out of the component body. Each page or component has a **co-located styles file**. The rule is constant; the syntax follows your styling stack.\n\n- **Tailwind (web):** `{name}.styles.ts` exports named class strings composed with `cn()` (clsx + tailwind-merge); variants via `cva`. JSX references `styles.header`.\n- **CSS Modules \u002F vanilla-extract:** a co-located `{name}.module.css` \u002F `{name}.css.ts`; JSX references `styles.header`.\n- **styled-components \u002F Emotion:** a co-located `{name}.styles.ts` exporting styled components.\n- **Tamagui (web + native):** a co-located `{name}.styles.ts` exporting `styled(...)` components or a `createStyledContext` \u002F `useStyle` token set; reference Tamagui tokens (`$background`, `$space.4`) — never hardcoded values inline. Tamagui is the recommended choice when you target **both web and React Native** from one codebase.\n- **React Native StyleSheet \u002F Nativewind:** a co-located `{name}.styles.ts` exporting `StyleSheet.create({...})` (or Nativewind classnames). JSX references `styles.header`.\n\n```ts\n\u002F\u002F invoice-list.styles.ts (Tailwind example)\nexport const invoiceListStyles = {\n  page: \"flex flex-col gap-8\",\n  header: \"flex flex-col gap-1.5\",\n  title: \"text-3xl font-semibold tracking-tight\",\n} as const;\n```\n\n```ts\n\u002F\u002F invoice-list.styles.ts (Tamagui example — works on web AND native)\nimport { styled, YStack, Text } from \"tamagui\";\n\nexport const InvoiceListPage = styled(YStack, { flex: 1, gap: \"$8\" });\nexport const InvoiceListHeader = styled(YStack, { gap: \"$1.5\" });\nexport const InvoiceListTitle = styled(Text, {\n  fontSize: \"$8\",\n  fontWeight: \"600\",\n});\n```\n\n**No inline `style={{...}}` literals in the component body**, on any stack. Why: styling drifts and duplicates when it lives inline. A co-located styles file gives one place to audit spacing rhythm, theme correctness, and responsive behavior per surface. Document non-obvious choices (accent locks, breakpoints) in comments there.\n\nThis skill does not dictate the _visual_ design — pair it with a design\u002Fcomponent skill for that. It dictates only _where styling lives_.\n\n---\n\n## 6. Naming conventions\n\nConsistent naming makes the structure self-describing.\n\n- **Interfaces are prefixed with `I`** — `IFeatureUiState`, `IInvoiceListParams`, `IUserProfile`. Type aliases (unions, mapped types, primitives) are **not** prefixed (`type SortDirection = \"asc\" | \"desc\"`).\n- **Components**: `PascalCase` files and exports — `InvoiceListPage.tsx`, `LineItemRow.tsx`.\n- **Pages\u002Fscreens**: `kebab-case` directories, the component file matches — `pages\u002Finvoice-list\u002Finvoice-list.tsx`.\n- **Hooks**: `useCamelCase` — `useInvoiceList`, `useFeatureUiStore`.\n- **Stores**: `{feature}.store.ts` (Zustand\u002FMobX), `{feature}.slice.ts` (Redux), `{feature}.atoms.ts` (Jotai). Hook is `use{Feature}{Purpose}Store`.\n- **Styles**: `{name}.styles.ts` co-located with its owner.\n- **Constants**: `SCREAMING_SNAKE_CASE` values; `kebab-case` or `camelCase` files.\n- **Barrels**: always `index.ts`.\n\n---\n\n## 7. Framework adapters\n\nThe module\u002Fpage\u002Fstate model is constant. Only the thin routing layer on top changes. Pages always live in `modules\u002F`; the routing layer just **mounts** them.\n\n### 7.1 Next.js (App Router)\n\n- `src\u002Fapp\u002F` holds route segments and route groups (`(marketing)`, `(app)`, `(public)`) for layout\u002Fauth boundaries. Route files are thin: import a page component from a module barrel and render it.\n- Default to **Server Components**; mark interactive leaves `\"use client\"`. Providers (query client, store, theme) live in a `\"use client\"` boundary.\n\n```tsx\n\u002F\u002F app\u002F(app)\u002Finvoices\u002Fpage.tsx — thin route file\nimport { InvoiceListPage } from \"@\u002Fmodules\u002Finvoice\";\nexport default function Page() {\n  return \u003CInvoiceListPage \u002F>;\n}\n```\n\n### 7.2 React + Vite (SPA)\n\n- A `src\u002Froutes\u002F` (or single `router.tsx`) declares the route table (React Router \u002F TanStack Router) and maps paths to module page components. Everything is client-side. Wrap the tree once with the query-client and store\u002Ftheme providers at the app root.\n\n### 7.3 Remix\n\n- Route modules in `app\u002Froutes\u002F` stay thin and re-export\u002Fmount module page components; loaders\u002Factions delegate to the module's `services\u002F`. Module boundaries are unchanged.\n\n### 7.4 Expo \u002F React Native\n\n- Routing is **Expo Router** (file-based, in `app\u002F`) or React Navigation (`navigation\u002F`). Route\u002Fscreen files are thin and import screen components from module barrels.\n- \"Pages\" are \"screens\" — same directory pattern: `pages\u002F{screen}\u002F{screen}.tsx` + `{screen}.styles.ts`.\n- Query layer + client store run unchanged (TanStack Query, Zustand, Redux, MobX, Jotai all work in RN). The typed `api-client` is shared logic and works as-is.\n- Styling uses **Tamagui** (recommended for shared web+native), `StyleSheet`, or Nativewind. Keep module logic DOM-free.\n\n```tsx\n\u002F\u002F app\u002Finvoices\u002Findex.tsx (Expo Router) — thin screen file\nimport { InvoiceListScreen } from \"@\u002Fmodules\u002Finvoice\";\nexport default InvoiceListScreen;\n```\n\n### 7.5 Sharing across web + native\n\nIf you target both web and Expo, push framework-free code (types, validators, formatters, the API client contract) into a shared package consumed by both apps, and prefer **Tamagui** for components that must render on both. Module boundaries stay the same on both sides.\n\n---\n\n## 8. Conventions checklist (enforce in review)\n\n- [ ] New feature → new `modules\u002F{feature}\u002F` with `index.ts` + `README.md`, not files scattered into `shared\u002F`.\n- [ ] New route → a **page\u002Fscreen directory** (`{page}.tsx` + `{page}.styles.ts` + `index.ts` + `README.md`), not a loose file.\n- [ ] Cross-module imports go through the barrel (`@\u002Fmodules\u002F{feature}`) — no deep internal paths.\n- [ ] Server data is in the query\u002Fcache layer; UI state is in the module store; **neither leaks into the other** (whatever libraries are chosen).\n- [ ] No `fetch()` in components — only typed data hooks built on the shared client.\n- [ ] No inline styles — co-located `{name}.styles.ts` (Tailwind\u002FCSS Modules\u002FTamagui\u002FStyleSheet\u002Fstyled-components).\n- [ ] Components\u002Fhooks\u002Futils placed at the narrowest scope; promoted only when a 2nd consumer appears.\n- [ ] One store unit per module, accessed via the barrel, with selectors and a `reset`.\n- [ ] Interfaces use the `I` prefix; components\u002Fhooks\u002Ffiles follow §6.\n- [ ] Query keys\u002Ftags come from a per-module factory; invalidation is hierarchical.\n- [ ] Routing files are thin — they mount module pages and own only layout\u002Fauth boundaries.\n- [ ] Module\u002Fpage READMEs updated when routes, params, or data deps change.\n\n---\n\n## 9. Component promotion (start local, move outward)\n\nA component is born in the narrowest scope that uses it and is **promoted** only when a second consumer appears. Never pre-place a component \"because it might be reused.\"\n\n| A component used by…   | Lives in                          | Imported as                        |\n| ---------------------- | --------------------------------- | ---------------------------------- |\n| Only one page          | `pages\u002F{page}\u002Fcomponents\u002F`        | relative path within the page      |\n| 2+ pages in one module | `modules\u002F{feature}\u002Fcomponents\u002F`   | `@\u002Fmodules\u002F{feature}` (via barrel) |\n| 2+ modules             | `shared\u002Fcomponents\u002F`              | `@\u002Fshared\u002F...`                     |\n| 2+ apps \u002F repos        | a published design-system package | the package name                   |\n\nThe same ladder applies to **hooks**, **utils**, and **constants**: local → module → shared → package. Promotion is a deliberate move (update the import sites), not a guess made up front.\n\n---\n\n## 10. How to apply this skill\n\n**Scaffolding a new app:** create `src\u002Fmodules\u002F`, `src\u002Fshared\u002F`, and the framework routing layer (§7). Add the shared `api-client`, the query layer, and your chosen client-store provider. Drop a store template into the first module.\n\n**Adding a feature:** create `modules\u002F{feature}\u002F` with the full subfolder set (`pages\u002F components\u002F hooks\u002F stores\u002F services\u002F utils\u002F constants\u002F types\u002F`), a curated `index.ts`, and a `README.md`. Build the first screen as a page directory.\n\n**Deciding where code goes:** ask \"who consumes this?\" → narrowest scope wins (§9). Ask \"where did this data come from?\" → server = query layer, UI = store (§4).\n\n**Reviewing structure:** run the checklist in §8. The most valuable catches are state-origin leaks (server data in the client store) and deep cross-module imports (bypassing the barrel) — both erode the architecture fastest.\n\n---\n\n## Publishing \u002F installing this skill\n\nThis skill follows the Anthropic `SKILL.md` format and is portable across agents. To make it installable and discoverable (e.g. on skills.sh \u002F `npx skills`):\n\n1. Put this folder under a `skills\u002F` directory in a **public GitHub repo** (path like `skills\u002Ffrontend-architecture\u002FSKILL.md`).\n2. Keep the frontmatter `name` and a high-signal `description` (above) — that description is what discovery indexes match against.\n3. Install from any project with: `npx skills add \u003Corg>\u002F\u003Crepo> --skill \"frontend-architecture\"`.\n4. Non-`SKILL.md` agents can be pointed here from `AGENTS.md` \u002F `CLAUDE.md`; Kiro can mirror it as a steering file.\n\n## Limitations\n\n- Use this skill only when the task clearly matches its upstream source and local project context.\n- Verify commands, generated code, dependencies, credentials, and external service behavior before applying changes.\n- Do not treat examples as a substitute for environment-specific tests, security review, or user approval for destructive or costly actions.\n","# Frontend Architecture (portable, module-based)\n## When to Use\n\nUse this skill when you need a portable, framework-agnostic architecture style for any React or React Native frontend. Organizes apps into feature modules with page\u002Fscreen directories, a strict server-state vs UI-state split, barrel-only cross-module imports, co-located styles, and clear component-promotion rules....\n\n\n> Portable skill — readable by Claude Code, OpenCode, Codex, Cursor, Windsurf, and others.\n> This skill describes a **structure and a set of rules**, not a component library, a state library, or a visual style.\n> It is deliberately global: the same module\u002Fpage\u002Fstate model maps onto\n> **Next.js (App Router)**, **React + Vite (SPA)**, **Remix**, and **Expo \u002F React Native**, and it works\n> with **any** state-management and styling stack.\n\nThe goal: a codebase where any contributor can instantly answer three questions —\n**\"where does this code live?\"**, **\"what is allowed to import what?\"**, and **\"is this server state or UI state?\"** —\nwithout asking anyone. The structure makes the answers obvious.\n\n---\n\n## 0. The five core ideas\n\n1. **Feature modules own their world.** Each feature is a self-contained `modules\u002F{feature}\u002F` folder with its own pages, components, hooks, state, types, and a single public barrel.\n2. **Pages\u002Fscreens are directories, not files.** A route is a folder that co-locates its component, its styles, and the components\u002Fhooks used only by it.\n3. **State is split by origin.** Server data lives in a query\u002Fcache layer. UI\u002Fclient state lives in a store. They never overlap — regardless of which libraries you pick.\n4. **Imports cross boundaries only through barrels.** Reaching into another module's internals is forbidden; you import from `@\u002Fmodules\u002F{feature}` and nothing deeper.\n5. **Code is promoted, not pre-placed.** It starts as local as possible and moves outward only when a second consumer appears.\n\nEverything below is the mechanical application of these five ideas. None of it is tied to a specific library — pick your stack in Sections 4 and 6.\n\n---\n\n## 1. Directory layout\n\nThe shape is identical across frameworks; only the routing layer on top differs (see Section 7).\n\n```\nsrc\u002F\n├── app\u002F or routes\u002F or navigation\u002F   ← framework routing layer (thin — see §7)\n├── modules\u002F                         ← feature modules (the heart of the app)\n│   └── {feature}\u002F\n│       ├── index.ts                 ← PUBLIC BARREL — the only cross-module entry point\n│       ├── README.md                ← what this module owns, its routes, its data deps\n│       ├── components\u002F              ← components reused by 2+ pages IN THIS MODULE\n│       ├── pages\u002F                   ← page\u002Fscreen directories (one per route)\n│       │   └── {page}\u002F\n│       │       ├── {page}.tsx               ← the page\u002Fscreen component\n│       │       ├── {page}.styles.ts         ← ALL styling for this page\n│       │       ├── index.ts                 ← re-exports the page component\n│       │       ├── components\u002F              ← components used ONLY by this page\n│       │       ├── hooks\u002F                   ← hooks used ONLY by this page\n│       │       ├── constants\u002F\n│       │       └── README.md                ← route, params, permissions, data deps\n│       ├── hooks\u002F                   ← data hooks (query\u002Fmutation) + module hooks\n│       ├── stores\u002F                  ← UI\u002Fclient state store(s) — never server data\n│       ├── services\u002F                ← data-access (API calls) for this feature\n│       ├── utils\u002F                   ← pure module utilities (co-located *.test.ts)\n│       ├── constants\u002F\n│       └── types\u002F                   ← module request\u002Fresponse + view-model types\n└── shared\u002F                          ← cross-module building blocks\n    ├── components\u002F                  ← components used by 2+ MODULES\n    ├── hooks\u002F                       ← cross-cutting hooks\n    ├── api-client\u002F                  ← one typed client; the only place that talks to the network\n    ├── store\u002F                       ← root store wiring (if your state lib needs one — see §4)\n    ├── utils\u002F                       ← formatters, cn()\u002Fclsx, helpers\n    ├── constants\u002F\n    └── types\u002F\n```\n\nEvery folder that can be empty at scaffold time keeps a `.gitkeep` so the structure is visible from day one.\n\n---\n\n## 2. Feature modules\n\nA module is a vertical slice of the product (e.g. `auth`, `billing`, `dashboard`, `settings`). It contains everything that feature needs and exposes a deliberately small surface.\n\n### 2.1 The barrel (`index.ts`) is the contract\n\n`modules\u002F{feature}\u002Findex.ts` is the **only** thing other modules and the routing layer may import from. It re-exports:\n\n- Page\u002Fscreen components the router mounts.\n- Data hooks other features legitimately need.\n- The store hook\u002Fslice and its public types.\n- Shared constants \u002F types other features depend on.\n\n```ts\n\u002F\u002F CORRECT — consume the public surface\nimport { InvoiceListPage, useInvoiceList } from \"@\u002Fmodules\u002Finvoice\";\n\n\u002F\u002F WRONG — reaching into internals couples you to private structure\nimport { InvoiceListPage } from \"@\u002Fmodules\u002Finvoice\u002Fpages\u002Finvoice-list\u002Finvoice-list\";\n```\n\nKeep the barrel curated. If something isn't exported, it's private by design. Group exports with short comments (pages, hooks, store, types) — future readers use the barrel as the module's API docs.\n\n### 2.2 One module = one bounded context\n\nDon't create `utils` modules or `components` modules. Modules map to product capabilities, not to technical layers. Technical building blocks live in `shared\u002F`.\n\n### 2.3 Module README\n\nEach module's `README.md` states: what it owns, which routes render its pages, its data dependencies (which endpoints\u002Fhooks), and any cross-module rules. This is the first thing a new contributor reads.\n\n---\n\n## 3. Pages\u002Fscreens as directories\n\nA page is a route the router mounts (a \"screen\" in React Native). It is **always a folder**, never a loose file — even when it starts as a single component. This keeps growth in place: when the page needs a sub-component or a hook, there is already a home for it.\n\n```\npages\u002F{page}\u002F\n├── {page}.tsx          ← the page\u002Fscreen component\n├── {page}.styles.ts    ← every style for this page (no inline styles — see §5)\n├── index.ts            ← export { PageComponent } from \".\u002F{page}\"\n├── components\u002F         ← used ONLY by this page\n├── hooks\u002F              ← used ONLY by this page\n├── constants\u002F\n└── README.md           ← route, params, permissions, data deps\n```\n\nThe page README is short and high-signal: route path, expected params, required permissions\u002Fauth, and the hooks it depends on. It is the contract between the page and the rest of the app.\n\n**Why folders from the start:** a page that begins as one file inevitably grows a sub-row component, a derived-totals hook, a styles file. If the page is a file, those land in arbitrary places. If the page is a folder, they have an obvious home and the diff stays readable.\n\n---\n\n## 4. State: split by origin (non-negotiable, library-agnostic)\n\nTwo kinds of state, two homes. Mixing them is the most common architectural failure this skill exists to prevent. **The split is mandatory; the libraries are your choice.**\n\n| State kind            | Examples                                                                          | Lives in                                                                                |\n| --------------------- | --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |\n| **Server state**      | fetched entities, lists, aggregates — anything the API owns                       | a **query\u002Fcache layer** (e.g. TanStack Query, RTK Query, SWR, Apollo)                   |\n| **UI \u002F client state** | open dialogs, table filters\u002Fsort, wizard step, draft being typed, preview toggles | a **client store** (e.g. Zustand, Redux Toolkit, MobX, Jotai, Valtio, or React Context) |\n\n### 4.1 Hard rules (independent of library)\n\n- **Never mirror server responses into the client store.** No copying fetched entities into Zustand\u002FRedux\u002FMobX. The query\u002Fcache layer is the single source of truth for server data.\n- **Never fetch inside components.** Components read server data from a data hook and UI state from a store selector. They don't call the network client directly.\n- **Never drive continuous values through re-render state.** Scroll progress, pointer position, drag offset — use refs \u002F animation values, not render state (it re-renders the tree every frame).\n- **One store boundary per module.** Whatever library you use, give each module one cohesive store unit (a Zustand hook, a Redux slice, a MobX class, a Jotai atom group) accessed via the module barrel. Components subscribe to the smallest slice they need to avoid needless re-renders.\n\n### 4.2 Choosing a client-state library — same shape, different syntax\n\nPick one per project and stay consistent. Each maps onto \"one store unit per module\" cleanly. Note the **`I` interface-naming convention**: state interfaces are prefixed with `I` (e.g. `IFeatureUiState`).\n\n**Zustand** — `modules\u002F{feature}\u002Fstores\u002F{feature}.store.ts`\n\n```ts\nimport { create } from \"zustand\";\n\nexport interface IFeatureUiState {\n  isPreviewOpen: boolean;\n  filter: string;\n  togglePreview: () => void;\n  setFilter: (filter: string) => void;\n  reset: () => void;\n}\n\nconst INITIAL_STATE = { isPreviewOpen: false, filter: \"\" } as const;\n\nexport const useFeatureUiStore = create\u003CIFeatureUiState>()((set) => ({\n  ...INITIAL_STATE,\n  togglePreview: () => set((s) => ({ isPreviewOpen: !s.isPreviewOpen })),\n  setFilter: (filter) => set({ filter }),\n  reset: () => set({ ...INITIAL_STATE }),\n}));\n```\n\n**Redux Toolkit** — `modules\u002F{feature}\u002Fstores\u002F{feature}.slice.ts` (registered in `shared\u002Fstore\u002F`)\n\n```ts\nimport { createSlice, type PayloadAction } from \"@reduxjs\u002Ftoolkit\";\n\nexport interface IFeatureUiState {\n  isPreviewOpen: boolean;\n  filter: string;\n}\n\nconst initialState: IFeatureUiState = { isPreviewOpen: false, filter: \"\" };\n\nexport const featureUiSlice = createSlice({\n  name: \"featureUi\",\n  initialState,\n  reducers: {\n    togglePreview: (s) => {\n      s.isPreviewOpen = !s.isPreviewOpen;\n    },\n    setFilter: (s, action: PayloadAction\u003Cstring>) => {\n      s.filter = action.payload;\n    },\n    reset: () => initialState,\n  },\n});\n```\n\n**MobX** — `modules\u002F{feature}\u002Fstores\u002F{feature}.store.ts`\n\n```ts\nimport { makeAutoObservable } from \"mobx\";\n\nexport interface IFeatureUiState {\n  isPreviewOpen: boolean;\n  filter: string;\n}\n\nexport class FeatureUiStore implements IFeatureUiState {\n  isPreviewOpen = false;\n  filter = \"\";\n  constructor() {\n    makeAutoObservable(this);\n  }\n  togglePreview = () => {\n    this.isPreviewOpen = !this.isPreviewOpen;\n  };\n  setFilter = (filter: string) => {\n    this.filter = filter;\n  };\n  reset = () => {\n    this.isPreviewOpen = false;\n    this.filter = \"\";\n  };\n}\n```\n\n**Jotai** — `modules\u002F{feature}\u002Fstores\u002F{feature}.atoms.ts`\n\n```ts\nimport { atom } from \"jotai\";\nexport const isPreviewOpenAtom = atom(false);\nexport const filterAtom = atom(\"\");\n```\n\n> Whichever you choose, keep the rules in §4.1 constant. The skill cares that server and UI state are separated and that each module owns one store unit — not which library draws the box.\n\n### 4.3 Data layer (server state)\n\nAll network access goes through **one typed client** in `shared\u002Fapi-client\u002F`. Modules wrap it in query\u002Fmutation hooks and a **key factory** so caches and invalidation stay consistent.\n\n```ts\n\u002F\u002F modules\u002Finvoice\u002Fhooks\u002FinvoiceKeys.ts — hierarchical key factory (TanStack Query style)\nexport const invoiceKeys = {\n  all: [\"invoices\"] as const,\n  lists: () => [...invoiceKeys.all, \"list\"] as const,\n  list: (params: IListParams) => [...invoiceKeys.lists(), params] as const,\n  details: () => [...invoiceKeys.all, \"detail\"] as const,\n  detail: (id: string) => [...invoiceKeys.details(), id] as const,\n} as const;\n```\n\nInvalidating `lists()` refreshes every filtered page; `detail(id)` targets one entity. (RTK Query\u002FSWR\u002FApollo express the same idea with tags\u002Fkeys.) Components never write raw `fetch()` — they call `useInvoiceList()` \u002F `useCreateInvoice()`.\n\n---\n\n## 5. Styling: co-located, no inline styles (styling-library agnostic)\n\nKeep styling out of JSX and out of the component body. Each page or component has a **co-located styles file**. The rule is constant; the syntax follows your styling stack.\n\n- **Tailwind (web):** `{name}.styles.ts` exports named class strings composed with `cn()` (clsx + tailwind-merge); variants via `cva`. JSX references `styles.header`.\n- **CSS Modules \u002F vanilla-extract:** a co-located `{name}.module.css` \u002F `{name}.css.ts`; JSX references `styles.header`.\n- **styled-components \u002F Emotion:** a co-located `{name}.styles.ts` exporting styled components.\n- **Tamagui (web + native):** a co-located `{name}.styles.ts` exporting `styled(...)` components or a `createStyledContext` \u002F `useStyle` token set; reference Tamagui tokens (`$background`, `$space.4`) — never hardcoded values inline. Tamagui is the recommended choice when you target **both web and React Native** from one codebase.\n- **React Native StyleSheet \u002F Nativewind:** a co-located `{name}.styles.ts` exporting `StyleSheet.create({...})` (or Nativewind classnames). JSX references `styles.header`.\n\n```ts\n\u002F\u002F invoice-list.styles.ts (Tailwind example)\nexport const invoiceListStyles = {\n  page: \"flex flex-col gap-8\",\n  header: \"flex flex-col gap-1.5\",\n  title: \"text-3xl font-semibold tracking-tight\",\n} as const;\n```\n\n```ts\n\u002F\u002F invoice-list.styles.ts (Tamagui example — works on web AND native)\nimport { styled, YStack, Text } from \"tamagui\";\n\nexport const InvoiceListPage = styled(YStack, { flex: 1, gap: \"$8\" });\nexport const InvoiceListHeader = styled(YStack, { gap: \"$1.5\" });\nexport const InvoiceListTitle = styled(Text, {\n  fontSize: \"$8\",\n  fontWeight: \"600\",\n});\n```\n\n**No inline `style={{...}}` literals in the component body**, on any stack. Why: styling drifts and duplicates when it lives inline. A co-located styles file gives one place to audit spacing rhythm, theme correctness, and responsive behavior per surface. Document non-obvious choices (accent locks, breakpoints) in comments there.\n\nThis skill does not dictate the _visual_ design — pair it with a design\u002Fcomponent skill for that. It dictates only _where styling lives_.\n\n---\n\n## 6. Naming conventions\n\nConsistent naming makes the structure self-describing.\n\n- **Interfaces are prefixed with `I`** — `IFeatureUiState`, `IInvoiceListParams`, `IUserProfile`. Type aliases (unions, mapped types, primitives) are **not** prefixed (`type SortDirection = \"asc\" | \"desc\"`).\n- **Components**: `PascalCase` files and exports — `InvoiceListPage.tsx`, `LineItemRow.tsx`.\n- **Pages\u002Fscreens**: `kebab-case` directories, the component file matches — `pages\u002Finvoice-list\u002Finvoice-list.tsx`.\n- **Hooks**: `useCamelCase` — `useInvoiceList`, `useFeatureUiStore`.\n- **Stores**: `{feature}.store.ts` (Zustand\u002FMobX), `{feature}.slice.ts` (Redux), `{feature}.atoms.ts` (Jotai). Hook is `use{Feature}{Purpose}Store`.\n- **Styles**: `{name}.styles.ts` co-located with its owner.\n- **Constants**: `SCREAMING_SNAKE_CASE` values; `kebab-case` or `camelCase` files.\n- **Barrels**: always `index.ts`.\n\n---\n\n## 7. Framework adapters\n\nThe module\u002Fpage\u002Fstate model is constant. Only the thin routing layer on top changes. Pages always live in `modules\u002F`; the routing layer just **mounts** them.\n\n### 7.1 Next.js (App Router)\n\n- `src\u002Fapp\u002F` holds route segments and route groups (`(marketing)`, `(app)`, `(public)`) for layout\u002Fauth boundaries. Route files are thin: import a page component from a module barrel and render it.\n- Default to **Server Components**; mark interactive leaves `\"use client\"`. Providers (query client, store, theme) live in a `\"use client\"` boundary.\n\n```tsx\n\u002F\u002F app\u002F(app)\u002Finvoices\u002Fpage.tsx — thin route file\nimport { InvoiceListPage } from \"@\u002Fmodules\u002Finvoice\";\nexport default function Page() {\n  return \u003CInvoiceListPage \u002F>;\n}\n```\n\n### 7.2 React + Vite (SPA)\n\n- A `src\u002Froutes\u002F` (or single `router.tsx`) declares the route table (React Router \u002F TanStack Router) and maps paths to module page components. Everything is client-side. Wrap the tree once with the query-client and store\u002Ftheme providers at the app root.\n\n### 7.3 Remix\n\n- Route modules in `app\u002Froutes\u002F` stay thin and re-export\u002Fmount module page components; loaders\u002Factions delegate to the module's `services\u002F`. Module boundaries are unchanged.\n\n### 7.4 Expo \u002F React Native\n\n- Routing is **Expo Router** (file-based, in `app\u002F`) or React Navigation (`navigation\u002F`). Route\u002Fscreen files are thin and import screen components from module barrels.\n- \"Pages\" are \"screens\" — same directory pattern: `pages\u002F{screen}\u002F{screen}.tsx` + `{screen}.styles.ts`.\n- Query layer + client store run unchanged (TanStack Query, Zustand, Redux, MobX, Jotai all work in RN). The typed `api-client` is shared logic and works as-is.\n- Styling uses **Tamagui** (recommended for shared web+native), `StyleSheet`, or Nativewind. Keep module logic DOM-free.\n\n```tsx\n\u002F\u002F app\u002Finvoices\u002Findex.tsx (Expo Router) — thin screen file\nimport { InvoiceListScreen } from \"@\u002Fmodules\u002Finvoice\";\nexport default InvoiceListScreen;\n```\n\n### 7.5 Sharing across web + native\n\nIf you target both web and Expo, push framework-free code (types, validators, formatters, the API client contract) into a shared package consumed by both apps, and prefer **Tamagui** for components that must render on both. Module boundaries stay the same on both sides.\n\n---\n\n## 8. Conventions checklist (enforce in review)\n\n- [ ] New feature → new `modules\u002F{feature}\u002F` with `index.ts` + `README.md`, not files scattered into `shared\u002F`.\n- [ ] New route → a **page\u002Fscreen directory** (`{page}.tsx` + `{page}.styles.ts` + `index.ts` + `README.md`), not a loose file.\n- [ ] Cross-module imports go through the barrel (`@\u002Fmodules\u002F{feature}`) — no deep internal paths.\n- [ ] Server data is in the query\u002Fcache layer; UI state is in the module store; **neither leaks into the other** (whatever libraries are chosen).\n- [ ] No `fetch()` in components — only typed data hooks built on the shared client.\n- [ ] No inline styles — co-located `{name}.styles.ts` (Tailwind\u002FCSS Modules\u002FTamagui\u002FStyleSheet\u002Fstyled-components).\n- [ ] Components\u002Fhooks\u002Futils placed at the narrowest scope; promoted only when a 2nd consumer appears.\n- [ ] One store unit per module, accessed via the barrel, with selectors and a `reset`.\n- [ ] Interfaces use the `I` prefix; components\u002Fhooks\u002Ffiles follow §6.\n- [ ] Query keys\u002Ftags come from a per-module factory; invalidation is hierarchical.\n- [ ] Routing files are thin — they mount module pages and own only layout\u002Fauth boundaries.\n- [ ] Module\u002Fpage READMEs updated when routes, params, or data deps change.\n\n---\n\n## 9. Component promotion (start local, move outward)\n\nA component is born in the narrowest scope that uses it and is **promoted** only when a second consumer appears. Never pre-place a component \"because it might be reused.\"\n\n| A component used by…   | Lives in                          | Imported as                        |\n| ---------------------- | --------------------------------- | ---------------------------------- |\n| Only one page          | `pages\u002F{page}\u002Fcomponents\u002F`        | relative path within the page      |\n| 2+ pages in one module | `modules\u002F{feature}\u002Fcomponents\u002F`   | `@\u002Fmodules\u002F{feature}` (via barrel) |\n| 2+ modules             | `shared\u002Fcomponents\u002F`              | `@\u002Fshared\u002F...`                     |\n| 2+ apps \u002F repos        | a published design-system package | the package name                   |\n\nThe same ladder applies to **hooks**, **utils**, and **constants**: local → module → shared → package. Promotion is a deliberate move (update the import sites), not a guess made up front.\n\n---\n\n## 10. How to apply this skill\n\n**Scaffolding a new app:** create `src\u002Fmodules\u002F`, `src\u002Fshared\u002F`, and the framework routing layer (§7). Add the shared `api-client`, the query layer, and your chosen client-store provider. Drop a store template into the first module.\n\n**Adding a feature:** create `modules\u002F{feature}\u002F` with the full subfolder set (`pages\u002F components\u002F hooks\u002F stores\u002F services\u002F utils\u002F constants\u002F types\u002F`), a curated `index.ts`, and a `README.md`. Build the first screen as a page directory.\n\n**Deciding where code goes:** ask \"who consumes this?\" → narrowest scope wins (§9). Ask \"where did this data come from?\" → server = query layer, UI = store (§4).\n\n**Reviewing structure:** run the checklist in §8. The most valuable catches are state-origin leaks (server data in the client store) and deep cross-module imports (bypassing the barrel) — both erode the architecture fastest.\n\n---\n\n## Publishing \u002F installing this skill\n\nThis skill follows the Anthropic `SKILL.md` format and is portable across agents. To make it installable and discoverable (e.g. on skills.sh \u002F `npx skills`):\n\n1. Put this folder under a `skills\u002F` directory in a **public GitHub repo** (path like `skills\u002Ffrontend-architecture\u002FSKILL.md`).\n2. Keep the frontmatter `name` and a high-signal `description` (above) — that description is what discovery indexes match against.\n3. Install from any project with: `npx skills add \u003Corg>\u002F\u003Crepo> --skill \"frontend-architecture\"`.\n4. Non-`SKILL.md` agents can be pointed here from `AGENTS.md` \u002F `CLAUDE.md`; Kiro can mirror it as a steering file.\n\n## Limitations\n\n- Use this skill only when the task clearly matches its upstream source and local project context.\n- Verify commands, generated code, dependencies, credentials, and external service behavior before applying changes.\n- Do not treat examples as a substitute for environment-specific tests, security review, or user approval for destructive or costly actions.\n",{"name":5,"risk":33,"source":48,"license":14,"date_added":49,"description":7,"source_repo":50,"source_type":26,"license_source":51},"https:\u002F\u002Fgithub.com\u002Fstareezy-1\u002Ffrontend-architecture-skill\u002Ftree\u002Fmain\u002Fskills\u002Ffrontend-architecture",1782864000000,"stareezy-1\u002Ffrontend-architecture-skill","https:\u002F\u002Fgithub.com\u002Fstareezy-1\u002Ffrontend-architecture-skill\u002Fblob\u002Fmain\u002FLICENSE","f3312ba749561b6159f477dbfc9313c875d40a56",".agents\u002Fskills_archive\u002Ffrontend-architecture","https:\u002F\u002Fgithub.com\u002Fduc-duy-1612\u002FOnline-Delivery-Systems-Web","https:\u002F\u002Fgithub.com\u002Fduc-duy-1612","2026-10-25 23:50:58",{"source":8,"skillName":5,"commands":58,"prompt":68,"zipAvailable":69},[59,62,65],{"tool":60,"command":61},"npx","npx skills add duc-duy-1612\u002FOnline-Delivery-Systems-Web --skill frontend-architecture",{"tool":63,"command":64},"bunx","bunx skills add duc-duy-1612\u002FOnline-Delivery-Systems-Web --skill frontend-architecture",{"tool":66,"command":67},"pnpm","pnpm dlx skills add duc-duy-1612\u002FOnline-Delivery-Systems-Web --skill frontend-architecture","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fduc-duy-1612\u002FOnline-Delivery-Systems-Web\u002Fblob\u002Fmain\u002F.agents\u002Fskills_archive\u002Ffrontend-architecture\u002FSKILL.md",true,[],[72,96,120,145,173,197],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":81,"publishedAt":43},"01M6Q0FA5FZ410Z33Z3TFQ4DBA","zero-trust","Implement zero-trust network architecture. Configure identity-based access, micro-segmentation, and continuous verification. Use when implementing modern security architectures.","https:\u002F\u002Fgithub.com\u002Fduc-duy-1612\u002FOnline-Delivery-Systems-Web\u002Fblob\u002Fmain\u002F.agents\u002Fskills_archive\u002Fzero-trust\u002FSKILL.md",[78],{"categoryNo":79,"categoryName":80,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000011","运维与部署",[82,83,84,23,85,86,74,87,88,89,90,37,26,35,91,33,92,93,94,95],"ZeRO","trust","zero trust","assessment","verification","segmentation","devops-security","access","configure","active","scope","scripts","relevant","implementing",{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":43},"01M6Q0F1YZJW3KX5FBKEVZ8CV4","zcode-delegate","Delegate coding tasks to the Z.AI ZCode CLI only when the user explicitly requests it, while the orchestrator retains review and landing responsibility.","https:\u002F\u002Fgithub.com\u002Fduc-duy-1612\u002FOnline-Delivery-Systems-Web\u002Fblob\u002Fmain\u002F.agents\u002Fskills_archive\u002Fzcode-delegate\u002FSKILL.md",[],[103,104,105,106,107,108,109,110,111,112,113,114,115,37,116,26,117,118,33,119],"delegate","zcode","zcode delegate","review","cli","orchestration","tasks","run","Bash","model","node","read","orchestrator","files","desktop app","app","agent-orchestration",{"skillNo":121,"name":122,"nameZh":6,"description":123,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":124,"categories":125,"keywords":126,"publishedAt":43},"01M6Q0ETK41VGNMYEXW0T00AJN","youtube-transcript","Fetch YouTube transcripts through DeepAPI or local fallback tooling and save clean text output.","https:\u002F\u002Fgithub.com\u002Fduc-duy-1612\u002FOnline-Delivery-Systems-Web\u002Fblob\u002Fmain\u002F.agents\u002Fskills_archive\u002Fyoutube-transcript\u002FSKILL.md",[],[127,128,129,130,131,132,133,134,135,136,137,138,139,26,35,140,141,142,143,144],"transcript","youtube transcript","youtube","safe","github","codex","research","license","https","text","fetch","tooling","clean","local","output","deepapi","youtube transcripts","blob",{"skillNo":146,"name":147,"nameZh":6,"description":148,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":149,"categories":150,"keywords":162,"publishedAt":43},"01M6Q0EPPH2PVMDW40017F8WX0","youtube-transcript-skills","Fetch YouTube video transcripts, search videos\u002Fchannels, browse channels, and extract playlists via the getyoutubetranscript.com API - free tier, no card required.","https:\u002F\u002Fgithub.com\u002Fduc-duy-1612\u002FOnline-Delivery-Systems-Web\u002Fblob\u002Fmain\u002F.agents\u002Fskills_archive\u002Fyoutube-transcript-skills\u002FSKILL.md",[151,154,157],{"categoryNo":152,"categoryName":153,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000010","后端与接口",{"categoryNo":155,"categoryName":156,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000016","图像与多媒体",{"categoryNo":158,"categoryName":159,"taxonomyType":160,"taxonomyTypeDesc":161},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[127,128,129,163,130,164,131,132,134,165,166,167,168,137,169,26,35,170,171,172],"youtube transcript skills","gemini","search","api","Video","browse","api-integration","free","card","channels",{"skillNo":174,"name":175,"nameZh":6,"description":176,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":177,"categories":178,"keywords":183,"publishedAt":43},"01M6Q0EAB96PX83W5PTE8A0R8D","youtube-notetaker","Turn YouTube talks into local study notes with slides, transcripts, editable annotations, and a markdown-backed viewer.","https:\u002F\u002Fgithub.com\u002Fduc-duy-1612\u002FOnline-Delivery-Systems-Web\u002Fblob\u002Fmain\u002F.agents\u002Fskills_archive\u002Fyoutube-notetaker\u002FSKILL.md",[179,182],{"categoryNo":180,"categoryName":181,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000003","演示文稿",{"categoryNo":155,"categoryName":156,"taxonomyType":20,"taxonomyTypeDesc":21},[129,184,185,107,130,186,187,188,189,134,167,190,191,192,193,35,194,140,195,196],"youtube notetaker","notetaker","workflow","official","notes","code","markdown","slides","annotations","README","study","dair-academy","viewer",{"skillNo":198,"name":199,"nameZh":6,"description":200,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":201,"categories":202,"keywords":204,"publishedAt":43},"01M6Q0E55F0GW5MX48V8HXS8B5","youtube-full","Fetch YouTube transcripts, search videos, browse channels, and extract playlists via TranscriptAPI — no yt-dlp, no Google API key, works from any cloud server.","https:\u002F\u002Fgithub.com\u002Fduc-duy-1612\u002FOnline-Delivery-Systems-Web\u002Fblob\u002Fmain\u002F.agents\u002Fskills_archive\u002Fyoutube-full\u002FSKILL.md",[203],{"categoryNo":152,"categoryName":153,"taxonomyType":20,"taxonomyTypeDesc":21},[205,129,206,207,130,164,165,39,208,166,167,168,137,209,169,26,35,170,210,143],"youtube full","full","google","dlp","credits","automatic"]