Installation

Installation Guide

Amanah Blueprint can be installed locally for a specific project or globally for all your development work.

1. Claude Code (Local Project)

The easiest way to get started with Claude Code is via npx. Run this command in your project's root directory:

npx amanah-blueprint

This command will:

• Create the .amanah/ directory.
• Bootstrap project-specific skills and agents in .claude/.
• Register the custom slash commands.

2. Gemini CLI (Global User)

For Gemini CLI users, we recommend a global installation so the framework is available in every repository.

Install Skills

gemini skills install amanah-blueprint.skill --scope user
gemini skills install atlas-generator.skill --scope user

Setup Global Commands

Copy the command definitions to your Gemini configuration directory:

Windows (PowerShell)

$dest = "$env:USERPROFILE\.gemini\commands"
New-Item -ItemType Directory -Force -Path $dest
Copy-Item "skill-source/gemini-commands/*.toml" -Destination $dest

3. Manual Installation

If you prefer a manual setup or are in a restricted environment:

# 1. Clone the repository
git clone https://github.com/NHadi/AmanahAgent.Blueprint.Skills.git
cd AmanahAgent.Blueprint.Skills

# 2. Run the installation script
bash install.sh

Note: Our installer is pinned to a specific secure commit to ensure supply-chain integrity.