skills.rest
HaydenDekker
HaydenDekkerCOMMUNITY
Explore all skills by this author →
GitHub

knot-init

Initialize a Knot rig structure and default profile in the current directory.

3|Updated Jun 3, 2026
Search Tags:#automation#init#state.json#profile#models.json#rig#knot
One-click install
npx skills add https://github.com/HaydenDekker/knot --skill knot-init
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: knot-init
Source: https://github.com/HaydenDekker/knot/tree/main/.agents/skills/knot-init
Command: npx skills add https://github.com/HaydenDekker/knot --skill knot-init

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Initialises a Knot rig in the current working directory by creating the rig structure and ensuring a running configuration, including a default profile when none exists.

Core Features & Use Cases

  • Idempotent rig initialisation: detects existing rigs and reports status instead of recreating.
  • Automatic profile setup: reads available models from ~/.pi/agent/models.json to populate a default profile if needed.
  • Guidance and state verification: validates Knot is running via rig/state.json and describes next steps for managing looms and knots.

Quick Start

Run knot-init in the current directory to initialise a Knot rig and create a default profile if none exists.

Frequently Asked Questions about knot-init

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

FAQPage Schema
How do I initialize a Knot rig in my current project directory?▼

Running knot-init creates the rig structure and a default profile in your current directory. It validates the setup by reading rig/state.json and populates the profile using available models from ~/.pi/agent/models.json.

What happens if I run knot-init on a project that already has a rig?▼

Knot-init is idempotent, detecting existing rigs and reporting their status instead of recreating them. This prevents overwriting your current rig structure or default profile configurations.

Do I need a models.json file to set up a default Knot profile?▼

No, a models.json file is not strictly required. Knot-init reads ~/.pi/agent/models.json to populate a default profile, but it uses placeholders to configure the rig if models.json is missing.

How does knot-init verify that Knot is running?▼

Knot-init verifies that Knot is running by establishing rig state and validating the setup through reading rig/state.json. This confirms the active configuration before proceeding with profile setup.

What prerequisites are needed before bootstrapping Knot rigs and defaults?▼

You need Knot installed on your system before bootstrapping. Knot-init requires this environment to establish the rig state, read configuration files, and verify the setup in your project directory.

Related Skills

Explore More Software Engineering Skills→
HaydenDekkerHaydenDekker
3

knot-inspect

Inspect Knot rig state, loom details, knot statuses, and agent profiles.

Community
Intermediate
HaydenDekkerHaydenDekker
3

knot-create

Automate loom, knot, and agent profile lifecycle via Markdown frontmatter files.

Community
Advanced
davekilleendavekilleen
461

pi

Execute Dex skills and custom commands through the Pi AI agent.

Community
Advanced
oxhagollioxhagolli
4

scaffold-engineer

Automate Python project bootstrapping with PyScaffold, pre-commit, and CLAUDE.md scaffolding.

Community
Intermediate