.agents

Skills, commands, and rules for AI-powered coding tools — used daily to supercharge development productivity.

This repository contains workflow commands, specialized skills, coding rules, and system hooks that work with any AI coding assistant that supports markdown-based configuration.

📦 What's Inside

.agents/
├── commands/        # 11 workflow automation commands
├── skills/          # 4 domain-specific skills
├── rules/           # 5 coding convention rules
├── claude-code-hooks.json   # Hook configuration (Claude Code specific)
├── claude-code-notifier.sh  # Cross-platform notification script
└── statusline.sh    # Custom status line for Claude Code terminal UI

🚀 Quick Start

Option 1: Clone Entire Setup

cd ~
git clone [email protected]:Weaverse/.agents.git

# Symlink into your AI tool's config directory
# For Claude Code:
ln -s ~/.agents/commands ~/.claude/commands
ln -s ~/.agents/skills ~/.claude/skills
ln -s ~/.agents/rules ~/.claude/rules

Option 2: Copy Individual Items

1. Browse the commands/, skills/, or rules/ folders
2. Copy the files you need into your AI tool's config directory

⚡ Workflow Commands

Automation commands for common development tasks:

🎯 Specialized Skills

Domain-specific procedures for complex tasks:

📏 Coding Rules

Opinionated conventions enforced across the team:

📊 Status Line

statusline.sh is a custom status line script for Claude Code's terminal UI. It displays:

• Session stats — duration, cost, and token usage
• Active model — shortened name (e.g., Sonnet 4.5)
• Working directory — last two path segments
• Git status — current branch + clean (✓) or dirty (✗) indicator

Setup (Claude Code):

ln -s ~/.agents/statusline.sh ~/.claude/statusline.sh

Then configure it in your Claude Code settings:

{
  "statusCommand": "~/.claude/statusline.sh"
}

🔔 System Hooks

The included claude-code-hooks.json and claude-code-notifier.sh enable system notifications for:

• Session start/end
• Task completion
• Custom alerts

Cross-platform support: macOS, Linux, Windows (PowerShell).

Note: Hooks are currently Claude Code specific. Contributions for other tools welcome.

🛠️ Development

See AGENTS.md for:

• Validation commands
• Code style guidelines
• Frontmatter requirements
• Quality checklist

🤝 Contributing

Contributions welcome! When adding new commands/skills:

1. Follow the naming convention: kebab-case.md
2. Include proper YAML frontmatter
3. Add 2-3 realistic usage examples
4. Test manually in your AI coding tool
5. Update relevant README sections

📝 License

MIT

Built by Weaverse — Empowering developers with AI-enhanced workflows.