Skip to content

Weaverse/.agents

Repository files navigation

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

About

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

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages