swain-init

Automate swain framework onboarding by migrating CLAUDE.md to AGENTS.md.

Updated Feb 22, 2026
One-click install
npx skills add https://github.com/cristoslc/tidegate --skill swain-init
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: swain-init
Source: https://github.com/cristoslc/tidegate/tree/main/.agents/skills/swain-init
Command: npx skills add https://github.com/cristoslc/tidegate --skill swain-init

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the initial setup process for new projects adopting the swain agent framework, ensuring all necessary configurations and migrations are handled automatically.

Core Features & Use Cases

  • Project Onboarding: Automates one-time setup tasks for swain.
  • Configuration Migration: Migrates existing CLAUDE.md content to AGENTS.md and sets up the @AGENTS.md include pattern.
  • Dependency Verification: Checks for and assists in installing necessary tools like uv and verifies the vendored tk script.
  • Governance Setup: Optionally adds swain's routing and governance rules to AGENTS.md.
  • Use Case: When starting a new project with swain, run this Skill once to ensure your project's documentation and agent configurations are correctly set up according to swain's best practices.

Quick Start

Run the swain-init skill to perform the one-time project onboarding.

Frequently Asked Questions about swain-init

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

FAQPage Schema
How do I migrate CLAUDE.md to AGENTS.md for project onboarding?

Migrating CLAUDE.md to AGENTS.md involves moving existing project instructions and setting up the `@AGENTS.md` include pattern. This ensures project documentation is correctly formatted for cross-tool compatibility during the one-time swain onboarding process.

What is the best way to set up a new project with the swain agent framework?

Setting up a new project with the swain agent framework is automated through a one-time onboarding process. This setup migrates configuration files, verifies dependencies like the vendored tk script, and optionally applies swain governance rules to AGENTS.md.

Do I need uv installed to configure swain governance rules?

Verifying uv installation is part of the swain onboarding dependency checks. While governance rules are optionally added to AGENTS.md, the setup process assists in checking for and installing necessary tools like uv to ensure the environment is ready.

How does swain project setup handle cross-tool compatibility for agent configurations?

Swain project setup handles cross-tool compatibility by migrating CLAUDE.md content into AGENTS.md and establishing the `@AGENTS.md` include pattern. This ensures project instructions are correctly formatted for multiple agent frameworks.

Why does my swain onboarding fail when verifying the vendored tk script?

Swain onboarding verifies the vendored tk script for task tracking during setup. If verification fails, the onboarding process assists in checking dependencies and resolving the issue to complete the project configuration.

Can I add swain routing rules to an existing AGENTS.md file?

Yes, you can add swain routing and governance rules to an existing AGENTS.md file. The onboarding process optionally appends these rules to ensure your project follows swain conventions and governance standards.