{"id":43185171,"url":"https://github.com/oscardrt/supastarter-nextjs-skill","last_synced_at":"2026-02-06T09:01:04.926Z","repository":{"id":335591900,"uuid":"1146390582","full_name":"OscarDRT/supastarter-nextjs-skill","owner":"OscarDRT","description":"Agent Skills–compliant skill for supastarter.","archived":false,"fork":false,"pushed_at":"2026-02-03T00:02:47.000Z","size":57,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-04T16:32:26.843Z","etag":null,"topics":["agent-skills","claude-code","nextjs","saas-boilerplate","supastarter"],"latest_commit_sha":null,"homepage":"https://skills.sh/oscardrt/supastarter-nextjs-skill/supastarter-nextjs-skill","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OscarDRT.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-31T02:46:42.000Z","updated_at":"2026-02-02T23:39:26.000Z","dependencies_parsed_at":"2026-02-02T05:04:56.707Z","dependency_job_id":null,"html_url":"https://github.com/OscarDRT/supastarter-nextjs-skill","commit_stats":null,"previous_names":["oscardrt/supastarter-nextjs-skill"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/OscarDRT/supastarter-nextjs-skill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OscarDRT%2Fsupastarter-nextjs-skill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OscarDRT%2Fsupastarter-nextjs-skill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OscarDRT%2Fsupastarter-nextjs-skill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OscarDRT%2Fsupastarter-nextjs-skill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OscarDRT","download_url":"https://codeload.github.com/OscarDRT/supastarter-nextjs-skill/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OscarDRT%2Fsupastarter-nextjs-skill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29116450,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-05T05:31:32.482Z","status":"ssl_error","status_checked_at":"2026-02-05T05:31:29.075Z","response_time":65,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","claude-code","nextjs","saas-boilerplate","supastarter"],"created_at":"2026-02-01T04:14:00.269Z","updated_at":"2026-02-05T08:00:53.999Z","avatar_url":"https://github.com/OscarDRT.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# supastarter Next.js Skill\n\n\u003e Agent Skills–compliant skill for [supastarter](https://supastarter.dev) **Next.js only** (no Vue/Nuxt). Expert guidance for the full stack: tech stack, setup, database (Prisma), API (Hono/oRPC), auth (Better Auth), organizations, payments (Stripe), AI, customization, storage, mailing, i18n, SEO, deployment, background tasks, analytics, monitoring, E2E.\n\n[![Agent Skills](https://img.shields.io/badge/Agent_Skills-Compatible-blue)](https://agentskills.io)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n## What is this?\n\nThis skill provides comprehensive guidance for building production-ready SaaS applications with supastarter for Next.js, including:\n\n- ✅ **SKILL.md** – When to use, workflow (schema → queries → API → UI → i18n), pointers to references and assets\n- ✅ **20+ reference docs** – Tech stack, setup, configuration, troubleshooting, database, API, auth, organizations, payments, AI, customization, storage, mailing, i18n, SEO, deployment, background tasks, analytics, monitoring, E2E\n- ✅ **Coding conventions** – Official supastarter coding style and architecture (read first before writing code)\n- ✅ **Code patterns** – Prisma, oRPC, Server/Client components, forms, shadcn, auth, organizations\n- ✅ **Quick reference** – Commands, file locations, env template, troubleshooting, deployment checklist\n- ✅ **Scripts** – `generate_module.py` to scaffold new API modules (oRPC)\n- ✅ **Assets** – `env.example`, full **feedback-widget** recipe (DB → API → UI → i18n)\n\n## Installation\n\n### Using npx skills (when supported)\n\n```bash\n# Install from GitHub\nnpx skills add OscarDRT/supastarter-nextjs-skill\n\n# Or with full URL\nnpx skills add https://github.com/OscarDRT/supastarter-nextjs-skill\n```\n\nThe skill directory is **supastarter-nextjs-skill** (Agent Skills spec: name matches folder).\n\n### Manual Installation (Cursor)\n\n1. Clone or download this repository\n2. Copy the **supastarter-nextjs-skill** folder to one of these locations:\n   - `~/.cursor/skills/supastarter-nextjs-skill/` (global)\n   - `.cursor/skills/supastarter-nextjs-skill/` (project-specific)\n\nDo not use `~/.cursor/skills-cursor/` (reserved for Cursor).\n\n## Usage\n\nOnce installed, the skill automatically activates when you:\n\n- Mention \"supastarter\" in your queries\n- Ask about building SaaS features\n- Request help with Next.js authentication, billing, or organizations\n- Need to generate code following supastarter conventions\n\n### Example Queries\n\n**Building Features:**\n```\n\"Help me build a task management feature in supastarter\"\n\"Show me how to add a new database model in supastarter\"\n\"Create a server component for displaying user analytics\"\n```\n\n**Following Conventions:**\n```\n\"Generate a new API route following supastarter conventions\"\n\"Create a form component with proper validation\"\n\"Show me the right way to handle authentication in supastarter\"\n```\n\n**Troubleshooting:**\n```\n\"I'm getting database connection errors in supastarter\"\n\"How do I fix TypeScript errors after updating Prisma?\"\n\"My build is failing, help me debug it\"\n```\n\n## What's Included\n\n### Skill layout (supastarter-nextjs-skill/)\n\n- **SKILL.md** – Frontmatter (name, description) + when to use, workflow, references table, scripts, conventions\n- **references/** – 23 markdown files: coding-conventions, code-patterns, quick-reference, tech-stack, setup, configuration, troubleshooting, database-patterns, api-patterns, auth-patterns, organization-patterns, payments-patterns, ai-patterns, customization, storage-patterns, mailing-patterns, internationalization, seo, deployment, background-tasks, analytics, monitoring, e2e-testing\n- **scripts/** – `generate_module.py` (scaffold oRPC module), `README.md` (usage)\n- **assets/** – `env.example`, `recipes/feedback-widget.md` (full DB → API → UI → i18n recipe)\n\n### Coding conventions (references/coding-conventions.md)\nRead first before writing code: architecture, TypeScript, React/Next.js, styling, forms, API, auth, i18n, tooling.\n\n### Code patterns (references/code-patterns.md)\nReady-to-use examples: Prisma models/queries, oRPC + TanStack Query, Server/Client components, react-hook-form + zod, shadcn, auth, organizations.\n\n### Quick reference (references/quick-reference.md)\nCommands, file locations (including oRPC paths), env template, troubleshooting, deployment checklist.\n\n## Requirements\n\nWorks with any Agent Skills-compatible tool:\n\n- ✅ Claude Code\n- ✅ Claude Desktop (with skills enabled)\n- ✅ OpenAI Codex CLI\n- ✅ Cursor (via skills)\n- ✅ Any tool supporting the Agent Skills format\n\n## Example Workflow\n\n```bash\n# 1. Install the skill (e.g. copy supastarter-nextjs-skill to ~/.cursor/skills/)\ncp -r supastarter-nextjs-skill ~/.cursor/skills/\n\n# 2. Open Cursor (or another Agent Skills–compatible tool)\n\n# 3. Ask for help with supastarter Next.js\n\"Build a feedback widget following the supastarter recipe\"\n\n# The skill activates and provides:\n# - Workflow: schema → queries → API → UI → i18n\n# - References (conventions, patterns, quick reference)\n# - Full feedback-widget recipe in assets/recipes/\n```\n\n## Features\n\n### 🎯 Intelligent Activation\nThe skill knows when to activate based on context - no need to manually invoke it.\n\n### 📚 Progressive Disclosure\nInformation is loaded on-demand to keep context efficient:\n1. Metadata always available\n2. Main docs when skill activates\n3. Detailed references as needed\n\n### ✨ Convention Compliance\nAll generated code follows supastarter's official conventions:\n- Named exports for components\n- Interfaces over types\n- Server Components by default\n- react-hook-form + zod for forms\n- And 20+ more conventions\n\n### 🔄 Up-to-date Patterns\nBased on supastarter Next.js architecture:\n- Next.js 14+ App Router\n- Prisma (schema, migrations, queries in `packages/database`)\n- Better Auth\n- Hono + oRPC (`packages/api/modules/`, procedures, router)\n- Biome for lint/format\n\n## Contributing\n\nIssues and PRs welcome! If you find bugs or have suggestions:\n\n1. Check existing issues first\n2. Open a new issue with details\n3. Or submit a PR with fixes/improvements\n\n## Related Resources\n\n- [supastarter Official Site](https://supastarter.dev)\n- [supastarter Documentation](https://supastarter.dev/docs/nextjs)\n- [Agent Skills Specification](https://agentskills.io)\n- [Agent Skills Examples](https://github.com/anthropics/skills)\n- [Skills Marketplace](https://skillsmp.com)\n\n## License\n\nMIT - See [LICENSE](LICENSE) file for details.\n\n## Disclaimer\n\nThis is a community-created skill to help developers work with supastarter. supastarter itself is a commercial product - please refer to their [official website](https://supastarter.dev) for licensing and purchase information.\n\n## Star History\n\nIf you find this skill useful, please consider giving it a ⭐ on GitHub!\n\n---\n\n**Made with ❤️ for the supastarter community**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foscardrt%2Fsupastarter-nextjs-skill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foscardrt%2Fsupastarter-nextjs-skill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foscardrt%2Fsupastarter-nextjs-skill/lists"}