ai-init

Initialize and configure ai-shell for new repositories or workspaces.

1|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/svange/augint-shell --skill ai-init
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ai-init
Source: https://github.com/svange/augint-shell/tree/main/.agents/skills/ai-init
Command: npx skills add https://github.com/svange/augint-shell --skill ai-init

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Initialize ai-shell for a new repository or workspace and choose the correct repo type and tool setup.

Core Features & Use Cases

  • Guides the user through selecting repository kind (library, service, or workspace)
  • Determines the required tool scope (--claude, --codex, --opencode, or --all)
  • Persists configuration for future runs and outputs the correct activation commands

Quick Start

Run ai-shell init with the appropriate flags to initialize your repository.

Frequently Asked Questions about ai-init

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

FAQPage Schema
How do I initialize ai-shell for a new repository?

You initialize ai-shell by running a setup workflow that prompts you to select a repository kind and tool scope, persisting these choices in an ai-shell.toml configuration file and outputting the correct activation commands for subsequent use.

What repository kinds can I choose when setting up ai-shell?

When setting up ai-shell, you can choose from three repository kinds: library, service, or workspace. Your selection is persisted in the ai-shell.toml configuration file to tailor the environment for future runs.

Can I configure ai-shell to work with different AI tools?

Yes, you can configure ai-shell for different AI tools by selecting a tool scope during initialization. You can choose claude, codex, opencode, or all, and the setup will output the correct activation commands for your selected tools.

Where does ai-shell store its configuration after running the init command?

The ai-shell init command stores its configuration in an ai-shell.toml file. This file persists your selected repository kind and tool scope choices to ensure a deterministic setup for future runs within that workspace.

Do I need an existing configuration to run the ai-shell setup workflow?

No, the ai-shell setup workflow applies specifically to uninitialized projects. It guides you through selecting the correct repository kind and tool scope from scratch to create the necessary configuration.