SkillsAdd

smithery.ai

secret-sauce

Development best practices and project patterns.

First seen Apr 1, 2026

Installation

$ npx skills add https://smithery.ai
View on skills.sh ↗ Website ↗

Summary

  • Development best practices and project patterns.
  • Use when starting projects, setting up CLAUDE.md, coding TypeScript/Next.js/React/Supabase, implementing AI flows, data fetching, testing, deployment, git workflows, browser automation, centralized configuration, or Tailwind CSS v4.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

supabase Shared topics
supabase/agent-skills

Use when doing ANY task involving Supabase. Triggers: Supabase products (Database, Auth, Edge F…

263K installs
vercel-react-best-practices Shared topics
vercel-labs/agent-skills 697.8K installs
supabase-postgres-best-practices Shared topics
supabase/agent-skills

Postgres best practices maintained by Supabase, for Postgres running anywhere. Load this skill …

391.6K installs
prisma-cli Shared topics
prisma/skills

Prisma ORM CLI commands reference covering init, generate, migrate, db, dev, complete, studio, …

267K installs
ai-sdk Shared topics
vercel/ai 53.4K installs
clerk-setup Shared topics
clerk/skills 42.6K installs

Also in this package

Other skills from smithery.ai · top by installs.

npx skills add https://smithery.ai
smithery-ai-cli 7.8K frontend-design 6.2K skill-creator 2.5K ck:ui-ux-pro-max 1.3K pdf 1.2K xlsx 966 pptx 894 docx 884 webapp-testing 1 web-design-reviewer 657

Browse all from smithery.ai

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Skill metadata

Parsed from SKILL.md frontmatter.

Declared agents claude-code

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 4,220 B
  • docs SUMMARY.md 301 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 1 installs

SKILL.md

Secret Sauce

Best practices, rules, and templates extracted from real production projects.

Quick Reference

Category Reference File
Tech Stack references/tech-stack.md
Project Setup references/claude-md-template.md
Project Tracking references/project-tracking.md
Coding Standards references/coding-standards.md
Centralization references/centralization-patterns.md
Tailwind v4 references/tailwind-v4.md
AI Development references/ai-flow-patterns.md
Data Fetching references/data-fetching.md
Git Workflow references/git-workflows.md
Testing references/testing-patterns.md
Supabase references/supabase-patterns.md
Deployment references/deployment-patterns.md
Browser Tools references/browser-automation.md
Versioning references/version-management.md

Framework Rules

Framework Rule File
TypeScript rules/typescript.md
Next.js rules/nextjs.md
React rules/react.md
Supabase rules/supabase.md
Security rules/security.md

Templates

Template Purpose
templates/CLAUDE.md.template Project configuration starter
templates/settings.json.template Permission configuration
templates/project-plan.md.template Project planning document
templates/implementation-plan.md.template Technical implementation plan
templates/code-review.md.template Code review summary
templates/changelog.md.template Project changelog

Usage

Starting a New Project

  1. Copy templates/CLAUDE.md.template to your project root as CLAUDE.md
  2. Customize sections for your stack
  3. Reference specific rules: ~/.claude/skills/secret-sauce/rules/typescript.md

Setting Up Permissions

  1. Copy templates/settings.json.template to .claude/settings.json
  2. Adjust permissions for your workflow

Project Documentation

Use templates for consistent project documentation:

  • project-plan.md.template for planning
  • implementation-plan.md.template for technical specs
  • code-review.md.template for reviews

Key Patterns

CLAUDE.md Structure

Every project CLAUDE.md should include:

  1. YAML frontmatter (title, status, owner, tags)
  2. Quick Reference section with key commands
  3. Active/Pending/Completed projects
  4. Stack-specific guidelines
  5. Development patterns

Git Workflow

  • Commit format: <type>(<scope>): <description>
  • Never commit without confirmation
  • Branch naming: feature/<name>, fix/<name>
  • PR template with summary and test plan

Centralization Pattern

All configuration in @/config:

import { env, isProduction, getServiceUrl } from '@/config';

Configuration Hierarchy

  1. Database configuration (system_configuration table)
  2. Environment variables (.env.local)
  3. Hardcoded defaults

Secrets (API keys) → .env.local only Configs (models, URLs) → Database with fallback

Testing Standards

  • Target: >90% coverage
  • Use Jest with 30s timeout for ML operations
  • Add new test directories to test runners
  • Security tests required for auth/validation

AI Flow Pattern

  1. Zod schemas for input/output
  2. Prompt builder functions
  3. OpenAI SDK v6 with zodResponseFormat()
  4. Error handling with Result types
  5. Server action wrapper

Data Fetching

  • Always pass signal to fetch calls
  • Use isAbortError() to handle cancellation
  • Memoize fetch options to prevent refetches
  • Use usePolling for dashboards with visibility-aware intervals

Security Checklist

  • Strict TypeScript (no any)
  • Zod input validation
  • Safe property access: Object.prototype.hasOwnProperty.call()
  • XSS prevention on all user inputs
  • Rate limiting in API routes