skills.rest
JohnRebellion
JohnRebellionCOMMUNITY
Explore all skills by this author →
GitHub

project-guidelines-example

Provides a project-specific skill template covering architecture, code patterns, testing, and deployment for a Next.js and FastAPI application.

Updated Apr 18, 2026
Search Tags:#template#testing#deployment#fastapi#next.js#code patterns#project guidelines
One-click install
npx skills add https://github.com/JohnRebellion/.claude-public --skill project-guidelines-example-johnrebellion
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-guidelines-example
Source: https://github.com/JohnRebellion/.claude-public/tree/main/claude/skills/project-guidelines-example
Command: npx skills add https://github.com/JohnRebellion/.claude-public --skill project-guidelines-example-johnrebellion

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a new project-specific skill from scratch is time-consuming, and teams often lack a concrete reference for what architecture details, code patterns, and workflow rules a good project skill should contain. ## Core Features & Use Cases - Architecture Documentation Template: Shows how to document a full-stack tech stack (Next.js 15, FastAPI, Supabase, Claude API, Cloud Run) with service diagrams and file structure. - Code Pattern Library: Includes reusable patterns for typed API responses in FastAPI/Pydantic, TypeScript fetch wrappers, Claude structured output via tool calling, and custom React hooks. - Testing and Deployment Standards: Demonstrates pytest and React Testing Library conventions, pre-deployment checklists, and Cloud Run deployment commands. - Use Case: A team bootstrapping guidelines for their own SaaS project can copy this template, swap in their stack details, and immediately give their AI assistant consistent project context. ## Quick Start Ask the assistant to apply this project guidelines template to document the architecture, code patterns, and testing requirements of your own application.

Frequently Asked Questions about project-guidelines-example

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

FAQPage Schema
How do I create a project-specific skill for my codebase?▼

Use this template as a starting point: document your architecture overview, file structure, code patterns, testing requirements, and deployment workflow in a SKILL.md file. Replace the example stack details with your own technologies and conventions.

How to get structured output from the Claude API in Python?▼

Define a Pydantic model for your result, pass its JSON schema as a tool definition, and set tool_choice to force that tool. The response contains a tool_use block whose input validates directly against your model.

What testing setup does this template recommend for FastAPI and React?▼

The backend uses pytest with httpx AsyncClient fixtures for async endpoint tests, while the frontend uses React Testing Library for component tests and Playwright for E2E. An 80 percent coverage minimum is enforced.

Can I use this template with a different tech stack than Next.js and FastAPI?▼

Yes, the structure is stack-agnostic: keep the sections for architecture, file structure, code patterns, testing, and deployment, then substitute your own frameworks, commands, and conventions.

What coding rules does this project template enforce?▼

It mandates no emojis in code, immutability, test-driven development, 80 percent coverage, small files of 200-400 lines, no console.log in production, proper error handling, and input validation with Pydantic or Zod.

Related Skills

Explore More Software Engineering Skills→
PaulKinlanPaulKinlan
2

codebase-survey

Survey codebases to inventory structure, dependencies, and programming patterns.

Community
Intermediate
barbosakjnbarbosakjn
1

code-review-checklist

Identify code quality, security, and best-practice issues during reviews.

Community
Advanced
nullhacknullhack

code-quality

Run ruff, pyright, and pytest coverage checks for Python projects.

Community
Intermediate
yulonghe97yulonghe97
8

import

Scan a codebase and generate a ystack module registry, progress files, and a documentation gap report.

Community
Advanced