setup

Configure Citadel harness and generate a personalized harness.json for your project's AI assistant workflow.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/mferris77/SpringBoard --skill setup-mferris77
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup
Source: https://github.com/mferris77/SpringBoard/tree/main/vscode-citadel-harness/skills/setup
Command: npx skills add https://github.com/mferris77/SpringBoard --skill setup-mferris77

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The setup skill removes friction from first-run configuration by detecting a project's stack, scaffolding harness files, installing hooks, and registering skills so users reach a working Citadel harness quickly.

Core Features & Use Cases

  • Automatic stack detection: Detects language, framework, package manager, and test tooling from common project files.
  • Idempotent scaffolding and hooks: Generates .claude/harness.json, installs hooks with resolved paths, and preserves existing settings without overwriting unless confirmed.
  • Live demonstration: Runs a real demo task on the user's code based on stated pain points and prints a concise reference card for next steps.
  • Optional integrations: Offers GitHub workflow and MCP server scaffolding as non-blocking, user-confirmed steps.

Quick Start

Run /do setup in your project root and follow the interactive prompts to detect the stack, create harness.json, install hooks, and run a demo task.

Frequently Asked Questions about setup

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

FAQPage Schema
How do I set up an AI assistant harness for an existing project repository?

To set up an AI assistant harness, run the setup command in your project root to detect the stack, generate .claude/harness.json, install plugin hooks, and register available skills automatically.

Can I scaffold a CLAUDE.md configuration without overwriting my existing project settings?

Yes, scaffolding CLAUDE.md and .claude settings is idempotent, preserving existing files and configurations without overwriting them unless you explicitly confirm the changes during the interactive prompts.

How does automatic stack detection work when bootstrapping a local-first AI workflow?

Automatic stack detection works by scanning common project files to identify your language, framework, package manager, and test tooling, then applying language-aware typecheck configuration to the generated harness.

What optional integrations can I add when configuring a project harness?

You can optionally add GitHub workflow and MCP server integrations as non-blocking, user-confirmed steps during the setup process to extend the functionality of your generated harness.

Does the setup process run a demo task on my actual codebase?

Yes, the setup process runs a live demonstration task directly on your real code based on stated pain points, then prints a concise reference card outlining next steps for your project.

What should I do if hook path resolution fails during project bootstrapping?

If hook path resolution fails during project bootstrapping, ensure your project root contains valid package manager or framework configuration files so the setup tool can correctly detect the stack and resolve paths.