skani.json

The skani.json file is heart of Skani. It tracks which skills are installed and their exact versions, enabling reproducible environments.

File Location

The skani.json file should be placed in the root of your project, alongside other configuration files like package.json or tsconfig.json.

Structure

Top-Level Fields

Field	Type	Description
`version`	string	Schema version (currently &quote;1.0.0&quote;)
`environment`	object	Metadata about this environment
`skills`	array	List of installed skills

Environment Object

Field	Type	Description
`name`	string	Human-readable name for this environment
`created`	string	ISO 8601 timestamp of creation
`updated`	string	ISO 8601 timestamp of last modification

Skill Object

Field	Type	Description
`id`	string	Unique identifier for skill
`name`	string	Human-readable name
`version`	string	Installed version (pinned)
`source`	object	Source configuration for fetching
`installedAt`	string	ISO 8601 timestamp of installation

Source Object

Field	Type	Description
`type`	string	Source type (currently &quote;github&quote;)
`owner`	string	GitHub repository owner
`repo`	string	Repository name
`ref`	string	Git reference (tag, branch, or commit)
`path`	string	Path to skill within repository

Example

{
  "version": "1.0.0",
  "environment": {
    "name": "my-project",
    "created": "2024-02-12T00:00:00Z",
    "updated": "2024-02-12T00:00:00Z"
  },
  "skills": [
    {
      "id": "omarchy",
      "name": "Omarchy",
      "version": "1.2.3",
      "source": {
        "type": "github",
        "owner": "anomalyco",
        "repo": "omarchy",
        "ref": "v1.2.3",
        "path": ".claude/skills/Omarchy"
      },
      "installedAt": "2024-02-12T10:30:00Z"
    }
  ]
}

Version Control

We recommend committing skani.json to version control. This allows team members and CI/CD systems to reproduce your skill environment exactly.

➜~git add skani.json

Skill Installation Location

When skills are installed, they are placed in .claude/skills/ directory at the root of your project. This directory structure is standard for agent skills.

.claude/
└── skills/
    ├── omarchy/
    │   ├── SKILL.md
    │   ├── templates/
    │   └── scripts/
    └── another-skill/
        └── SKILL.md

CLI Commands

Quick Start →