setup-fresh-project

Initialize git, tooling, documentation, and OpenCode LSP configuration for new projects.

103|21|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/archibate/dotfiles-opencode --skill setup-fresh-project
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup-fresh-project
Source: https://github.com/archibate/dotfiles-opencode/tree/main/skills/setup-fresh-project
Command: npx skills add https://github.com/archibate/dotfiles-opencode --skill setup-fresh-project

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you quickly and correctly set up a brand-new code project so tooling, formatting, documentation, and folder structure are ready from day one.

Core Features & Use Cases

  • Git initialization and ignore hygiene: Ensures the repository starts clean with an appropriate .gitignore.
  • Tooling and style configuration: Adds language-appropriate formatting/linting setup (and sensible defaults like 4-space indentation guidance).
  • LSP readiness: Sets up OpenCode LSP configuration guidance, including common per-language configuration fixes (e.g., Pyright with venv).
  • Use Case: Starting a new Python, TypeScript, Lua, or C/C++ project and wanting a reliable baseline that supports building, testing, and editor diagnostics without manual guesswork.

Quick Start

Tell the AI: "Set up my fresh project and generate the right git, formatting, and LSP configuration for Python using uv + ruff and pyright, and propose a best-practice folder structure for tests."

Frequently Asked Questions about setup-fresh-project

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

FAQPage Schema
How do I set up a new Python project with uv, ruff, and pyright LSP configuration?

To set up a new Python project, this Skill initializes git, configures uv and ruff for formatting, and sets up pyright LSP with venv handling. It generates the appropriate config files and a complete README without placeholders.

What is the best way to bootstrap a new TypeScript repository with safe git defaults?

Bootstrapping a new TypeScript repository is best done by applying consistent git initialization, tooling, and documentation from day one. This ensures formatting, linting, and OpenCode LSP configuration are ready before implementation begins.

Does this project setup tool work with C/C++ and Lua ecosystems?

Yes, this project setup tool works with C/C++ and Lua ecosystems. It applies when starting these projects, providing language-appropriate formatting, linting setup, and editor diagnostics configuration to ensure a reliable baseline.

How do I fix pyright venv issues when configuring LSP for a fresh project?

Fixing pyright venv issues during LSP configuration is handled by applying common per-language fixes. The setup provides specific guidance for OpenCode LSP to correctly resolve virtual environments in Python projects.

Can I generate a best-practice folder structure for tests when initializing a new repo?

Yes, you can generate a best-practice folder structure for tests when initializing a new repo. The setup creates a clear project structure and README that fully supports building and testing without manual guesswork.

What should be included in a .gitignore for a new cross-language software project?

A .gitignore for a new cross-language software project should include language-appropriate hygiene rules to keep the repository clean. This setup ensures the repository starts with safe defaults tailored to the chosen stack.