auto-setup

Detects project type and configures quality gates, hooks, and settings for new codebases.

1|Updated May 6, 2026
One-click install
npx skills add https://github.com/surfingalien/FinSurfing --skill auto-setup-surfingalien
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: auto-setup
Source: https://github.com/surfingalien/FinSurfing/tree/main/.claude/skills/auto-setup
Command: npx skills add https://github.com/surfingalien/FinSurfing --skill auto-setup-surfingalien

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Onboarding to a new or unfamiliar codebase often means manually figuring out which linter, type checker, test runner, and formatter to use. This Skill automates that discovery and writes a ready-to-use configuration. ## Core Features & Use Cases - Project Type Detection: Identifies Node.js/TypeScript, Python, Rust, or Go projects by checking for manifest files like package.json, pyproject.toml, Cargo.toml, and go.mod. - Quality Gate Configuration: Generates lint, typecheck, test, and format commands tailored to the detected stack (e.g., ruff and mypy for Python, clippy and cargo test for Rust). - Tool Verification: Confirms each required tool is installed and reports missing ones with install commands. - Use Case: You clone an unfamiliar repository and want consistent checks before committing. Run the setup to detect the stack, verify tooling, and write a .claude/settings.json with the right quality gates and hooks. ## Quick Start Set up quality gates and project settings for this repository by detecting its project type and configuring the appropriate lint, typecheck, test, and format commands.

Frequently Asked Questions about auto-setup

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

FAQPage Schema
How do I set up lint and test commands for a new project automatically?

Run the auto-setup workflow, which detects your project type from manifest files like package.json or pyproject.toml and generates matching lint, typecheck, test, and format commands. The result is written to .claude/settings.json.

What project types does automatic quality gate setup support?

It supports Node.js/TypeScript, Python, Rust, and Go. Each stack gets tailored commands, such as ruff and mypy for Python, clippy and cargo test for Rust, and golangci-lint with go vet for Go.

Does auto-setup work with monorepos?

Yes, it checks for workspace configurations to support monorepos. Detection is based on actual files present rather than assumptions, so mixed or multi-package projects are handled.

Will auto-setup overwrite my existing settings.json?

No, it never overwrites existing settings without asking first. You review and approve suggested permission rules and configuration changes before they are applied.

What happens if a required tool like ruff or clippy is not installed?

Each command is verified with a version or help check. Missing tools are reported in the output along with the specific install command needed to add them.