astroflare

Skills are modular, self-contained packages that extend agent capabilities with:

• Specialized workflows for specific domains
• Tool integrations and instructions
• Domain expertise and best practices
• Bundled resources (scripts, references, assets)

Skills use progressive disclosure - keeping SKILL.md files under 200 lines with detailed content in references/ directories loaded on-demand.

Install All Skills (Recommended)

Install all skills globally (to ~/.cursor/skills/, ~/.claude/skills/, etc. depending on agent):

```bash

npx add-skill siviter-xyz/dot-agent --yes --global --agent cursor

```

Install Specific Skills

Install individual skills by name:

```bash

# Install a single skill

npx add-skill siviter-xyz/dot-agent --skill typescript --yes --global

# Install multiple specific skills

npx add-skill siviter-xyz/dot-agent --skill typescript --skill python --skill astroflare --yes --global

```

List Available Skills

See all available skills without installing:

```bash

npx add-skill siviter-xyz/dot-agent --list

```

Install to Specific Agents

Target specific agent harnesses:

```bash

# Install to Cursor only

npx add-skill siviter-xyz/dot-agent -a cursor --yes --global

# Install to multiple agents

npx add-skill siviter-xyz/dot-agent -a cursor -a claude-code --yes --global

```

Project-Level Installation

Install skills to your project (committed in repo):

```bash

# Install all skills to project

npx add-skill siviter-xyz/dot-agent --yes

# Install specific skill to project

npx add-skill siviter-xyz/dot-agent --skill psi --yes

```

For more options, see the [add-skill documentation](https://github.com/vercel-labs/add-skill).

Sync from Local Repository

When working on dot-agent locally, sync all skills to your local agent installation:

```bash

# Sync all skills from local dot-agent repo to Cursor

npx add-skill $(pwd) --yes --global --agent cursor

# Sync to multiple agents

npx add-skill $(pwd) --yes --global --agent cursor --agent claude-code

# Sync specific skills only

npx add-skill $(pwd) --skill python --skill typescript --yes --global --agent cursor

```

This is useful when developing or modifying skills locally before publishing.

See [skills/README.md](skills/README.md) for a complete list of available skills.

For project-specific rules and commands, commit them in your repository:

• AGENTS.md: Project root or subdirectories for inline rules (works across agent harnesses, PREFERRRED)
• Rules: .cursor/rules/, .claude/rules/, .codex/rules/, etc. in your repo
• Commands: .cursor/commands/, .claude/commands/, .codex/commands/, etc. in your repo

Keep project-specific content small and focused. Use skills for reusable knowledge.

All skills follow the progressive disclosure principle:

• SKILL.md < 200 lines - Core principles and when to use
• references/ - Detailed documentation loaded on-demand
• scripts/ - Executable code for deterministic tasks
• assets/ - Files used in output (templates, etc.)

This keeps context windows clean while providing access to specialized capabilities when needed.

Skills are designed to be:

• Focused - Each skill covers a specific domain
• Reusable - Work across projects and teams
• Maintainable - Clear structure with progressive disclosure

When contributing:

1. Keep SKILL.md under 200 lines
2. Use references/ for detailed content

3.