skills.rest
adamrdrew
adamrdrewCOMMUNITY
Explore all skills by this author →
GitHub

describe-canonical-locations

Define the .ushabti directory structure with laws.md, style.md, docs/, and phases/.

7|1|Updated Jan 27, 2026
Search Tags:#documentation#state-management#phases#project-structure#ushabti#canonical-location
One-click install
npx skills add https://github.com/adamrdrew/ushabti --skill describe-canonical-locations
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: describe-canonical-locations
Source: https://github.com/adamrdrew/ushabti/tree/main/skills/describe-canonical-locations
Command: npx skills add https://github.com/adamrdrew/ushabti --skill describe-canonical-locations

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Defines the canonical storage locations for Ushabti state data and documentation, enabling predictable discovery and management of invariants, conventions, and phase data.

Core Features & Use Cases

  • Canonical directory: .ushabti/ with laws.md, style.md, docs/, and phases/
  • No duplicates: No mirrors or copies of state information
  • Use Case: Ensures all state-related files are found in a single, well-known location across projects

Quick Start

Create or verify the single source of truth at .ushabti/ and organize laws.md, style.md, docs/, and phases/ under it

Frequently Asked Questions about describe-canonical-locations

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

FAQPage Schema
How do I organize Ushabti state files for consistent project management?▼

Organize Ushabti state files by placing them in a single canonical .ushabti directory. This structure centralizes laws.md, style.md, docs/, and phases/ to enable predictable discovery and management of project invariants.

What is the canonical location for storing Ushabti project conventions and phase data?▼

The canonical location for Ushabti project conventions and phase data is the .ushabti directory. It acts as the single source of truth, housing laws.md, style.md, docs/, and phases/ without creating duplicates or mirrors.

How do I set up the .ushabti directory structure for state management?▼

Set up the .ushabti directory structure by creating the root folder and organizing laws.md, style.md, docs/, and phases/ under it. This establishes a single, well-known location for all state-related files across projects.

Does Ushabti allow mirroring or copying state information across multiple directories?▼

Ushabti does not allow mirrors or copies of state information. It enforces a strict single source of truth by defining one canonical storage location at .ushabti to prevent data fragmentation across projects.

Why do I need a canonical directory for Ushabti state data?▼

A canonical directory for Ushabti state data is needed to ensure predictable discovery of invariants, conventions, and phase information. It eliminates the overhead of searching multiple locations by standardizing storage in .ushabti.

What files belong in the .ushabti directory for managing project phases?▼

The .ushabti directory manages project phases by containing the phases/ subdirectory alongside laws.md, style.md, and docs/. This structure organizes all phase information and conventions in one predictable location.

Related Skills

Explore More Software Engineering Skills→
PixelSculptorPixelSculptor

10x-init

Create a project context directory with change tracking, archiving, and documentation files.

Community
Basic
adamrdrewadamrdrew
7

describe-required-inputs

Validate required .ushabti/laws.md and .ushabti/style.md files before agent activation.

Community
Basic
adamrdrewadamrdrew
7

check-ushabti-prerequisites

Validate Ushabti prerequisite files across project roles during setup.

Community
Basic
adamrdrewadamrdrew
7

get-phase-status

Parse Ushabti progress.yaml files to report phase statuses and step counts.

Community
Intermediate