skills.rest
alessioroberto82
alessioroberto82COMMUNITY
Explore all skills by this author →
GitHub

init

Initializes Circle framework output directories and session state for a project.

1|Updated Feb 19, 2026
Search Tags:#project setup#configuration#initialization#domain detection#session migration#circle framework#ai roles
One-click install
npx skills add https://github.com/alessioroberto82/claude-plugin-circle --skill init-alessioroberto82
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: init
Source: https://github.com/alessioroberto82/claude-plugin-circle/tree/main/plugins/circle/skills/init
Command: npx skills add https://github.com/alessioroberto82/claude-plugin-circle --skill init-alessioroberto82

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up the Circle framework for a new project requires creating output directories, detecting the project domain, and migrating legacy session state — all without polluting the project repository. This Skill automates that one-time initialization. ## Core Features & Use Cases - Zero-Footprint Setup: Creates all output, shard, and workspace directories under ~/.circle/projects/<project>/ so nothing is added to the project repository. - Domain Detection: Inspects project markers (package.json, go.mod, business-plan.md, etc.) to classify the project as software, business, personal, or general. - Session State Migration: Creates a v2 session-state.json file or idempotently migrates legacy v1 state with a safety backup. - Use Case: After cloning a repository, run initialization once to prepare Circle's external workspace, detect the project domain, and get a summary of available roles and optional integrations. ## Quick Start Ask the AI to initialize Circle for the current project and set up its output directories.

Frequently Asked Questions about init

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

FAQPage Schema
How do I set up the Circle framework for a new project?▼

Run the init skill once per project. It derives the project name from the current directory, detects the domain from project marker files, and creates all output directories under ~/.circle/projects/<project>/ without touching the repository.

Does Circle initialization add files to my project repository?▼

No. Circle follows a zero-footprint approach: all outputs, shards, session state, and workspace files are stored in the home directory under ~/.circle/projects/<project-name>/, never inside the project repository.

How does Circle detect the project domain during initialization?▼

It scans for marker files: software markers like package.json, go.mod, or Cargo.toml indicate a software domain; business-plan.md or strategy.md indicate business; goals.md or a habits folder indicate personal. Otherwise it defaults to general.

What happens if my session-state.json is an older version?▼

The skill runs an idempotent v1-to-v2 migration: it backs up the original to session-state.v1-backup.json, moves workflow fields into a session entry, sets version 2, and removes obsolete root fields. Invalid JSON triggers a warning and an offer to start fresh.

Does Circle init install external integrations automatically?▼

No. It only inspects available host integrations and local binaries, then explains which integrations might help. Nothing is installed or connected without explicit user confirmation through the host plugin manager.

Related Skills

Explore More Software Engineering Skills→
tranhieutttranhieutt
70

sync-template

Synchronize the .claude directory from an upstream template repository.

Community
Intermediate
sizukutamagosizukutamago

web-requirements

Generates web project user stories with Gherkin acceptance criteria from Swarm-driven analysis and story mapping.

Community
Advanced
alessioroberto82alessioroberto82

init

Initializes Circle framework output directories and session state for a project.

Community
Intermediate
jokerman89jokerman89

role

Activates, rotates, and deactivates session roles that apply role-specific lenses to workflow phases.

Community
Advanced