setup

Configures Beislið project workflow files and updates installed distributions interactively.

10|Updated May 12, 2026
One-click install
npx skills add https://github.com/sandsower/beislid --skill setup-sandsower
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: setup
Source: https://github.com/sandsower/beislid/tree/main/skills/setup
Command: npx skills add https://github.com/sandsower/beislid --skill setup-sandsower

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams using Beislið need a consistent, reviewable way to create and maintain the per-project .beislid/workflow.md config without hand-editing YAML blocks or risking silent overwrites. ## Core Features & Use Cases - Interactive first-run setup: Detects git remotes, ticket ID patterns, branch naming conventions, and default branches, then composes a minimal workflow.md with explicit Y/n confirmations. - Menu-driven section management: Add, change, or remove optional config sections such as quality gates, model routing, lifecycle actions, ticket updates, and PR review sources, always showing a diff before any destructive write. - Distribution updates and recovery: Runs the Beislið installer update flow from the install manifest, and recovers from malformed workflow.md files with line-numbered parse diagnostics. - Use Case: After cloning a repo, run the setup skill to detect GitHub Issues as the ticket source, suggest a branch pattern matching 18 of 20 recent branches, write .beislid/workflow.md, and insert the Agent skills block into AGENTS.md. ## Quick Start Ask the agent to run /setup in your repository to configure the Beislið workflow file step by step.

Frequently Asked Questions about setup

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

FAQPage Schema
How do I configure Beislið workflow.md for a new project?▼

Run the setup skill in a git repository with at least one commit. It inspects your git remote, recent commit messages, and branch names to suggest a ticket source, branch pattern, and PR base, then shows a preview before writing .beislid/workflow.md.

How do I update an installed Beislið distribution?▼

Invoke setup with update intent such as "setup update" or "update beislid". It reads the install manifest at ~/.local/state/beislid/install.json, confirms the plan, and runs install.sh --update from the recorded repo checkout.

Does setup overwrite my existing workflow.md without asking?▼

No. Every destructive write shows a diff and waits for explicit Y/n confirmation. Reset mode first backs up the current file to .beislid/workflow.md.bak before regenerating from scratch.

What happens if my workflow.md has a parse error?▼

Setup runs a line-numbered diagnosis of the failing beislid block, reports which sections parsed cleanly, and offers either a reset-and-regenerate flow with backup or a clean exit so you can fix the file manually or run /doctor.

Can setup configure quality gates and lifecycle hooks?▼

Yes. Menu mode offers optional sections including scopes and quality gates, lifecycle actions, lifecycle hooks, model routing, ticket updates, PR review sources, and agent isolation, each with its own guided sub-interview.

Will setup modify my CLAUDE.md file?▼

No. Setup never modifies CLAUDE.md. It only creates or updates the Agent skills section in AGENTS.md, which is the always-preferred target for agent integration instructions.