{
  "markdown": "# nextjs-skills\n\nA collection of agent skills for Next.js workflows. The repository\ncurrently includes two skills: `nextjs-cache-architecture` and\n`next-action-handler`.\n\n[![skills.sh](https://skills.sh/b/mohamed-hossam1/nextjs-cache-architecture)](https://skills.sh/mohamed-hossam1/nextjs-cache-architecture)\n<!-- [![skills.sh](https://skills.sh/b/mohamed-hossam1/next-action-handler)](https://skills.sh/mohamed-hossam1/next-action-handler) -->\n\n## Skills\n\n- `nextjs-cache-architecture` helps design and implement caching in\n  Next.js 16+ App Router projects, covering tag registries, cache\n  boundaries, revalidation utilities, and debugging stale data.\n- `next-action-handler` standardizes server actions with input/output\n  validation, error normalization, auth context, and pino logging on\n  top of `next-safe-action` and `zod`.\n\n## Repository layout\n\n```\nskills/\n├── nextjs-cache-architecture/\n│   ├── SKILL.md                                # Always-loaded core: architecture + steps + common mistakes\n│   ├── overlay.yaml                            # Routing manifest (prompt signals, validators)\n│   ├── references/                             # Loaded on demand\n│   ├── assets/                                 # Drop-in templates the agent copies into your repo\n│   ├── scripts/                                # Verifiers and generators\n│   └── evals/                                  # Test cases for the skill\n├── next-action-handler/\n│   ├── SKILL.md\n│   └── references/                             # Loaded on demand\nsrc/                                            # Shared runtime code used by skills\n```\n\n## Usage\n\nInstall a skill from this repository with `npx skills add`:\n\n```bash\nnpx skills add https://github.com/mohamed-hossam1/nextjs-skills --skill nextjs-cache-architecture\nnpx skills add https://github.com/mohamed-hossam1/nextjs-skills --skill next-action-handler\n```\n\n## Verifying an implementation\n\n`nextjs-cache-architecture` includes a static audit script at\n`skills/nextjs-cache-architecture/scripts/audit.mjs`. Run it after\napplying the skill to confirm the checklist items are in place.\n\n## Requirements\n\n### `nextjs-cache-architecture`\n\n| Requirement                                 | Status |\n| ------------------------------------------- | ------ |\n| Next.js 16+                                 | Yes    |\n| `cacheComponents: true` in `next.config.ts` | Yes    |\n| App Router                                  | Yes    |\n| Pages Router                                | No     |\n| Edge runtime                                | No     |\n| Static export (`output: \"export\"`)          | No     |\n\n### `next-action-handler`\n\n- Next.js App Router with server actions\n- `next-safe-action`, `zod`, `better-auth`, and `pino` (installed by the skill)\n\n## Contributing\n\nSee [AGENTS.md](./AGENTS.md) for style, naming, and structure rules.\nEach skill prefers fixing the architecture over working around it —\nevery new pattern must justify its place by a real mutation or\nrendering case.\n\n## License\n\nMIT\n\n## Author\n\nMohamed Hossam (`mohamed-hossam1`).\n",
  "bytes": 3075,
  "sha": "14a72a3a4eb550af630c27ba1bd695c0566387f5652196fea6421a1c02b21b72",
  "repo_slug": "mohamed-hossam1/nextjs-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_mohamed_hossam1_nextjs_skills_nextjs_cac_de597786/readme"
}