init

Installs repository-owned procedure skills with per-host wrappers and stamps them in config.json.

Updated Sep 2, 2026
One-click install
npx skills add https://github.com/JSdotNet/devbook --skill init-jsdotnet
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: init
Source: https://github.com/JSdotNet/devbook/tree/main/plugins/devbook-procedures/skills/init
Command: npx skills add https://github.com/JSdotNet/devbook --skill init-jsdotnet

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve? Adopting the devbook-procedures plugin requires seeding four procedure skills (start, show, capture, debug) into a repository as editable copies, each with a managed wrapper per host (Claude Code and GitHub Copilot), without overwriting files the repository already owns. ## Core Features & Use Cases - First-time seeding: Writes each adopted procedure skill byte-for-byte into .agents/skills/ plus a managed SKILL.md wrapper under .claude/skills/ and .github/skills/ carrying the fixed goal and pointer. - Ownership detection: Hashes files already on disk, asks once per procedure whether to keep an unstamped file as the repository's own or replace it with the seed, and never merges a newer seed into a customized file. - Plan-before-write and stamping: Always presents a create/update/skip-customized plan before writing, then records components.devbook-procedures with plugin version, adopted entries, and materialized hashes in .devbook/config.json. - Use Case: A team adopting devbook-procedures runs init once to seed the start and capture skills, keeps their existing customized debug skill untouched, and gets a stamped config entry so future runs go through update instead. ## Quick Start Run devbook-procedures init to seed the start, show, capture, and debug procedure skills into this repository.

Frequently Asked Questions about init

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

FAQPage Schema
How do I install the devbook-procedures skills into my repository?▼

Run devbook-procedures init once. It asks which of the four procedures (start, show, capture, debug) to adopt, writes each as an editable copy under .agents/skills/, and adds a managed wrapper per host under .claude/skills/ and .github/skills/.

What happens if I run devbook-procedures init twice?▼

The run is refused when components.devbook-procedures already exists in .devbook/config.json. It reports "already initialized, run devbook-procedures:update" and stops without writing anything.

Will init overwrite my customized skill files?▼

No. Init hashes files on disk and only overwrites a file whose hash matches a release the plugin shipped. A file with an unknown hash is treated as the repository's own, reported, and left untouched.

What is the difference between the skill copy and the host wrapper?▼

The copy under .agents/skills/ holds the procedure content and is the repository's to edit. The wrapper under .claude/skills/ and .github/skills/ is managed by the plugin and carries only the fixed goal and a pointer, so it is replaced without asking.

What does init write into .devbook/config.json?▼

It writes only the components.devbook-procedures entry, recording pluginVersion, the adopted procedures, and materialized entries with the release each file came from and the hash it had when it landed. No other config entry is touched.