setup

Detects project stack and configures Seal Harness instruction files, coverage thresholds, and command shims.

1|Updated Jun 23, 2026
One-click install
npx skills add https://github.com/seal-harness/seal-harness --skill setup-seal-harness
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup
Source: https://github.com/seal-harness/seal-harness/tree/main/.agents/skills/setup
Command: npx skills add https://github.com/seal-harness/seal-harness --skill setup-seal-harness

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up an AI agent orchestration framework in an existing project requires manually detecting the language, test runner, linter, and CI system, then writing platform-specific instruction files and coverage configuration by hand. This Skill automates that entire onboarding flow through interactive detection and guided questions. ## Core Features & Use Cases - Automatic Project Detection: Scans marker files to identify language, framework, package manager, test runner, linter, formatter, type checker, CI, and git hooks without asking the user. - Platform-Specific Configuration: Writes or appends instruction files for Codex (AGENTS.md), Claude (CLAUDE.md), Gemini (GEMINI.md), or OpenCode, plus coverage thresholds and Claude command shims via a mandatory setup script. - Project Profile & Knowledge Base: Creates docs/project-profile.json with all detection results and seeds a JSONL knowledge base, shell utilities, CI templates, and gitignore entries. - Use Case: A developer installs Seal Harness in an existing TypeScript/React repository and invokes the setup skill; it detects vitest, pnpm, ESLint, and GitHub Actions, asks for a coverage threshold, then writes all required configuration files in one pass. ## Quick Start Run the setup skill in your project root and answer the interactive questions to configure Seal Harness for your detected stack.

Frequently Asked Questions about setup

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

FAQPage Schema
How do I set up Seal Harness in an existing project?

Invoke the setup skill from your project root. It silently detects your language, framework, test runner, and CI, asks 3-5 targeted questions such as coverage threshold, then writes instruction files, .coverage-thresholds.json, and a project profile automatically.

How does the setup skill detect my test runner and framework?

It scans marker files: package.json and tsconfig.json for Node/TypeScript, pyproject.toml for Python, go.mod for Go, and Cargo.toml for Rust. Frameworks are detected from dependencies, and test runners from config files like vitest.config or jest.config.

Which AI coding platforms does the setup skill support?

It supports Codex, Claude Code, Gemini, and OpenCode. Each platform gets its own instruction file (AGENTS.md, CLAUDE.md, GEMINI.md, or OPENCODE.md), and Claude additionally receives command shims in .claude/commands/.

Can I re-run setup if my project is already configured?

Yes. The pre-flight check looks for docs/project-profile.json and asks whether to re-run or skip. Re-running overwrites previous choices, and the flow is designed to never leave the project half-configured.

What happens if the mandatory setup script fails or is missing?

The skill falls back to writing the required files manually with the Write tool, including the platform instruction file and .coverage-thresholds.json. A final verification step checks all mandatory files exist before declaring setup complete.