.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 git@github.com: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:

Command	Description
work	Pick up a GitHub issue — fetch context, create branch, generate spec plan, and optionally open a draft PR
create-task	Create a GitHub issue with full metadata and optional project board integration
create-pr	Create pull requests with AI-generated descriptions
fix-pr	Fix issues raised in PR reviews
review-changes	Review uncommitted changes before pushing
review-code	In-depth code quality analysis
format	Auto-format code and fix TypeScript issues
handoff	Generate context summaries for team handoffs
explain	Explain recent code changes in simple terms for junior developers
ship	Create a release PR, bump version, and draft a GitHub release
ultrathink	Deep reasoning mode for complex problems

🎯 Specialized Skills

Domain-specific procedures for complex tasks:

Skill	Description
commit	Commit changes with well-crafted messages, grouping related files into separate commits
code-review	Comprehensive code audits — dead code, duplications, patterns, bugs
feature-plan	Detailed implementation planning before writing code
frontend-design	Create distinctive, production-grade UI components

📏 Coding Rules

Opinionated conventions enforced across the team:

Rule	Description
coding	Naming, styling, and general coding standards
commit	Commit message conventions
communication	How AI should handle questions vs statements
never-auto-commit	Prevent AI tools from auto-committing
spec-driven-development	Write specs before code

📊 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.