⚡ Quick Start Guide

Bootstrap your project with core meta-skills, then add what you need.

🎯 What You'll Learn

This guide shows you how to:

  1. Initialize a project with Phoenix's core meta-skills
  2. Use meta-skills to browse and install additional skills
  3. Configure nightlife.yaml to use custom skill repositories

🚀 Step 1: Initialize Your Project

# Create a new project
uvx --from git+https://github.com/dauquangthanh/vinh-phoenix.git phoenix init <PROJECT_NAME> --ai claude

# OR initialize in current directory
uvx --from git+https://github.com/dauquangthanh/vinh-phoenix.git phoenix init --here --ai claude

This installs 5 core meta-skills into the agent-specific folder and places nightlife.yaml in your project root.

What's installed:

<project-root>/
├── .claude/skills/         (for Claude Code)
│   ├── git-commit/
│   ├── list-skills/
│   ├── add-skills/
│   ├── list-agents/
│   └── add-agents/
└── nightlife.yaml

🔍 Step 2: Browse Available Skills

Launch your AI assistant and ask it to show what's available:

"List available skills"

The list-skills meta-skill reads nightlife.yaml, fetches the catalog from the configured URLs (GitHub issues or Azure DevOps files), and shows you all installable skills.

Example output:

Repository: vinh-phoenix-skills (https://github.com/owner/skills-repo)
  - requirements-specification
  - requirements-specification-review
  - technical-detailed-design
  - task-management
  - coding
  - code-review
  - git-commit
  - ... (more)
  Total: N skills available

➕ Step 3: Install the Skills You Need

Ask your AI to install specific skills:

"Install the requirements-specification, technical-detailed-design, task-management, and coding skills"

The add-skills meta-skill downloads and installs each skill into the correct folders for all detected AI IDEs in your project.

🤖 Step 4: Browse and Install Agent Commands

Agent commands are slash-command style shortcuts. Browse and install them the same way:

"List available agent commands"
"Install the specify and architect agent commands"

📄 Understanding nightlife.yaml

nightlife.yaml controls where the meta-skills look for skill and agent catalogs. It supports both GitHub and Azure DevOps as catalog sources:

# DaNang Nightlife - Agent & Skill Repository Configuration
urls:
  # GitHub issue (issue body contains YAML repo list)
  - https://github.com/DauQuangThanh/vinh-phoenix/issues/2
  # Azure DevOps file (YAML file in a repo)
  # - https://dev.azure.com/myorg/myproject/_git/myrepo?path=/catalog.yaml&version=GBmain

Each URL points to a catalog source. The content should be YAML listing repositories:

skills:
  - name: my-skills
    url: https://github.com/owner/my-skills-repo      # GitHub
    branch: main
    path: skills
  - name: internal-skills
    url: https://dev.azure.com/org/proj/_git/skills    # Azure DevOps
    branch: main
    path: skills

Using Your Own Repositories

To use a private or custom skill catalog, update nightlife.yaml:

urls:
  - https://github.com/my-org/my-config/issues/1
  - https://dev.azure.com/my-org/my-project/_git/config?path=/catalog.yaml&version=GBmain

Structure the issue body or file with your repos. Your AI assistant's list-skills and add-skills will automatically use your custom catalog.

🧩 Understanding the Meta-Skills

Each meta-skill is self-contained with scripts and follows the Agent Skills standard:

Meta-Skill Trigger What It Does
git-commit "commit my changes" Generates a Conventional Commits message and commits
list-skills "list skills", "what skills?" Queries configured repos, displays available skills
add-skills "install skills", "add skills" Downloads skill folders into all detected AI IDEs
list-agents "list agents", "what agents?" Queries configured repos, displays available agent commands
add-agents "install agents", "add agents" Downloads agent command files into all detected AI IDEs

🎯 Key Principles

Principle What It Means
Start Minimal Only 5 meta-skills installed by default
Grow On Demand Use add-skills to install what your project needs
Stay in Control Edit nightlife.yaml to configure your own skill sources
Multi-Agent Skills install to all detected AI IDEs automatically

📚 Next Steps

Edit this page