init

Creates and scaffolds a new git-based knowledge base with zones, grants, and maintenance schedules.

3|1|Updated Jul 17, 2026
One-click install
npx skills add https://github.com/AlmogBaku/aos --skill init-almogbaku
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: init
Source: https://github.com/AlmogBaku/aos/tree/main/capabilities/kb/skills/init
Command: npx skills add https://github.com/AlmogBaku/aos --skill init-almogbaku

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a personal knowledge base from scratch involves many error-prone decisions: directory structure, write permissions, sync behavior, and recurring maintenance jobs. This Skill interviews the user once, scaffolds the entire tree, and wires the schedules so the base is operational immediately. ## Core Features & Use Cases - Structured Interview: Collects name, path, audience (private/shared), sync mode, purpose, zones, types, and curation policy in a single pass. - Scaffolding & Registration: Runs kb init to render templates, git-init the repo, register the base in kb-registry.yaml, and apply zone/type adjustments via kb config set. - Schedule Wiring: Creates the three maintenance jobs (nightly promote, weekly lint, 5-minute sync) with the correct environment variables, or degrades to manual run-cards when the harness has no cron. - Use Case: During bootstrap, a user says "set me up a personal knowledge base" — the Skill interviews them, scaffolds ~/personal-base, registers it, and verifies kb lint reports zero findings. ## Quick Start Ask your agent to create a new knowledge base, for example: "create a work knowledge base called work-base with private audience and manual sync."

Frequently Asked Questions about init

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

FAQPage Schema
How do I create a new knowledge base with kb init?▼

Run kb init with a name, path, audience, sync mode, and purpose, optionally adding a remote and curation policy. The tool renders templates, git-inits the repo, registers the base in kb-registry.yaml, and commits the result.

What is the difference between kb init and kb-adopt?▼

kb init creates a fresh knowledge base from templates when none exists yet. kb-adopt registers an existing knowledge tree already on disk, and kb-import transforms another KB's content into a base.

Can I use rebase-5min sync without a git remote?▼

No. The rebase-5min sync mode requires a remote, but nothing enforces it — the cron job will report 'synced (no remote)' and exit 0 while syncing nothing. Choose manual sync and switch later if you have no remote yet.

Why does the nightly promote job fail lint with grants-audit criticals?▼

The job is missing AOS_AGENT=agent:archiver in its environment, so it runs as agent:main which lacks write grants on entities, concepts, and projects. Every promotion commits as the wrong subject and the weekly lint flags each one.

What happens if my harness has no cron support?▼

All three maintenance jobs degrade to manual run-cards: the command and trigger for each are written down and surfaced to the user, since nothing will run them automatically otherwise.