feature-scaffold

Scaffold ChatbotX feature directories and implementation patterns following project conventions.

601|129|Updated Dec 9, 2024
One-click install
npx skills add https://github.com/ChatbotXIO/ChatbotX --skill feature-scaffold-chatbotxio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feature-scaffold
Source: https://github.com/ChatbotXIO/ChatbotX/tree/main/.agents/skills/feature-scaffold
Command: npx skills add https://github.com/ChatbotXIO/ChatbotX --skill feature-scaffold-chatbotxio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams add new ChatbotX features without breaking architectural conventions, route structure, or localization standards. It reduces setup time for pages, actions, queries, schemas, and UI patterns by giving a consistent scaffold to follow.

Core Features & Use Cases

  • Feature Layout Guidance: Organizes new work into the expected feature folders for actions, queries, schema, components, hooks, and API handlers.
  • Page and Form Patterns: Shows the preferred server-component page flow, client-component promise handling, and Card-based form layouts.
  • Platform Conventions: Reinforces next-safe-action, oRPC, workspace-aware auth checks, structured logging, and next-intl usage.
  • Use Case: A developer adding a new workspace feature can follow this Skill to build the directory structure, wire data access correctly, and ship localized UI with fewer implementation mistakes.

Quick Start

Use this skill to scaffold a new ChatbotX feature that follows the repository’s page, action, query, and translation conventions.

Frequently Asked Questions about feature-scaffold

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scaffold new Next.js feature directories without breaking project conventions?

Scaffold new Next.js feature directories by generating structured folders for server actions, queries, schemas, and UI components that enforce workspace-scoped workflows and business-logic separation. This ensures new features align with existing route structures and platform conventions.

What is the best way to organize server actions and queries in a feature folder?

Organize server actions and queries in a feature folder by separating data access, schemas, and API handlers into dedicated subdirectories. This approach isolates business logic from feature components and maintains consistency with oRPC and next-safe-action patterns.

Do I need next-intl and next-safe-action to build workspace-scoped features?

Yes, building workspace-scoped features requires next-safe-action for action validation, oRPC for routing, and next-intl for localization. These dependencies enforce structured logging and workspace-aware authentication checks across the scaffolded feature architecture.

How do I structure localized pages with Card-based forms in a Next.js workspace app?

Structure localized pages by using server-component page flows that pass promises to client-components, wrapping forms in Card-based layouts, and applying next-intl translations. This pattern ensures localization standards are met without breaking feature folder conventions.

Why does my feature architecture violate workspace-aware auth checks when adding new routes?

Feature architecture violates workspace-aware auth checks when API handlers and server actions bypass workspace-scoped workflows. Scaffold features with next-safe-action and structured logging to enforce authentication boundaries and maintain route structure integrity.

Can I use this scaffolding pattern for public routes and builder app pages alike?

Yes, the scaffolding pattern applies to both builder app pages and public routes in workspace-scoped workflows. It generates directory structures for API handlers, UI components, and server actions while maintaining platform conventions for each route type.