agents-skills

A community-driven collection of custom agents, skills, rules, and knowledge designed to enhance GitHub Copilot and AI development experiences across various domains, languages, and frameworks. Following OpenAI harness engineering principles for agent-centered development.

🚀 Features

• 🤖 Agents - Specialized GitHub Copilot agents with MCP server integration
• 📋 Skills - Self-contained task-specific instructions with bundled resources
• 📚 Rules - Coding standards and best practices for different languages and frameworks
• ⚡ Workflows - Agentic workflows for GitHub Actions automation
• 🧠 Knowledge - Memory documents, patterns, and migration guides
• 🛠️ Installation Scripts - Easy setup across multiple IDEs and CLIs
• 🧹 Utility Scripts - System maintenance and cleanup tools

📁 Repository Structure

agents-skills/
├── agents/           # Custom GitHub Copilot agent definitions
├── skills/           # Task-specific skills with bundled resources
├── rules/            # Coding standards and guidelines
├── workflows/        # Agentic workflows for automation
├── knowledge/        # Knowledge base (structured docs following OpenAI patterns)
│   ├── design-docs/  # Design patterns, core beliefs, architectural principles
│   ├── exec-plans/   # Active/completed execution plans, tech debt tracker
│   ├── generated/    # Auto-generated documentation
│   ├── product-specs/ # Product specifications
│   ├── references/   # Framework-specific guides
│   ├── DESIGN.md     # Design principles and patterns
│   ├── FRONTEND.md   # Frontend design patterns
│   ├── PLANS.md      # Planning templates
│   ├── PRODUCT_SENSE.md # Product principles
│   ├── QUALITY_SCORE.md # Quality metrics and scoring
│   ├── RELIABILITY.md # Reliability requirements
│   └── SECURITY.md   # Security guidelines
├── install.sh        # Installation script for all IDEs
├── rm-backup.sh      # Cleanup script for backups
├── clear-up-linux.sh # Linux system cleanup script
└── git-cleanup-repos.sh # Git repository maintenance script

🎯 Quick Start

Installation

Install skills, rules, and knowledge for your preferred IDE:

# Install for all IDEs/CLIs
./install.sh --all

# Install for specific IDEs
./install.sh --vscode --cursor --devin

# Install for ABP.IO development
./install.sh --vscode --cursor

Supported IDEs/CLIs

• VS Code (GitHub Copilot)
• Windsurf (Cascade)
• Cursor
• Devin / Devin Review / Devin CLI
• Claude Code
• Gemini CLI (Google)
• OpenClaw

📋 Categories

🏗️ Framework Support

ASP.NET Boilerplate & ABP.IO

• Rules: aspnetboilerplate.instructions.md, abp-io.instructions.md
• Skills:
  • create-aspnetboilerplate-project - Traditional ASP.NET Boilerplate setup
  • create-abp-io-template - Modern ABP.IO CLI-based creation
  • create-abp-project - ABP.IO project creation with template selection
  • migrate-aspnetboilerplate-to-abp - Complete migration guidance
• Knowledge: aspnetboilerplate-to-abp-migration-guide.md

.NET Development

• C#: Async programming, testing frameworks (MSTest, NUnit, xUnit), EF Core
• Architecture: DDD patterns, SOLID principles, clean architecture
• Web: ASP.NET Core, Blazor, API development

🔧 Development Tools

Code Quality & Review

• Generic: Universal code review guidelines and best practices
• Security: Comprehensive security standards and vulnerability prevention
• Performance: Optimization patterns and monitoring strategies

Project Management

• GitHub Issues: Issue creation, management, and workflow automation
• Implementation Planning: Structured planning templates and methodologies
• Documentation: Automated documentation generation and maintenance

🌐 Web Development

Frontend

• JavaScript/TypeScript: Modern JS patterns, testing with Jest
• UI/UX: Premium frontend UI components and design systems

Backend

• APIs: RESTful design, OpenAPI documentation
• Databases: PostgreSQL, SQL Server, optimization strategies

🛠️ Installation Scripts

install.sh

Comprehensive installation script supporting:

• Selective IDE installation
• Automatic backup of existing configurations
• Support for multiple IDEs/CLIs
• Cross-platform compatibility (Windows, Linux, macOS)

# Usage examples
./install.sh --all                    # All IDEs
./install.sh --vscode                 # VS Code only
./install.sh --cursor --devin         # Multiple IDEs
./install.sh -a                       # All IDEs (short)
./install.sh -v -d -g                 # VS Code + Devin + Gemini (short)

rm-backup.sh

Cleanup script to remove backup files created during installation:

./rm-backup.sh

clear-up-linux.sh

Comprehensive Linux system cleanup script with 20+ cleanup categories (documentação completa):

# Basic cleanup
sudo ./clear-up-linux.sh

# Dry run simulation
sudo ./clear-up-linux.sh --dry-run --verbose

# Non-interactive mode (for cron/automation)
sudo ./clear-up-linux.sh --force

# With BleachBit deep cleaning
sudo ./clear-up-linux.sh --bleachbit

# Full combination
sudo ./clear-up-linux.sh --force --verbose --bleachbit

Features:

• System logs, APT cache, temporary files cleanup
• Docker containers, images, volumes, build cache, and system prune
• aaPanel comprehensive cleaning (13 categories)
• Development caches: pip, npm, yarn, pnpm, Cargo (Rust), Go, Gradle, Maven, Composer (PHP), NuGet (.NET), Gem (Ruby)
• Python __pycache__ and virtualenv caches
• Flatpak unused runtimes cleanup
• Core dumps and crash reports removal
• Orphaned packages and residual configurations purge
• Unused locales, font cache, and man pages
• Swap and kernel memory cache cleanup
• Mail queue cleanup (Postfix/Exim) and mail logs
• Large orphan file identification (ISO, IMG, VMDK)
• Old system files (.dpkg-old, .bak, rotated logs)
• System caches (ldconfig, APT lists, PackageKit, icon cache)
• PostgreSQL logs, MySQL binary logs, web cache
• BleachBit integration for deep cleaning
• Journal cleanup (1-day retention, 100MB max)
• Interactive and batch modes with dry-run support

git-cleanup-repos.sh

Git repository maintenance and cleanup script:

# Make executable and run
chmod +x git-cleanup-repos.sh
./git-cleanup-repos.sh

# Run from specific directory
cd /path/to/projects && ./git-cleanup-repos.sh

Features:

• Recursive Git repository discovery
• Git fetch, pull, reflog cleanup, and garbage collection
• Build artifact removal (bin, obj, .vs, node_modules)
• Detailed timestamped logging
• Before/after repository statistics
• Safe operations with validation

📚 Knowledge Base

Following OpenAI harness engineering principles with structured knowledge organization:

Core Documents

• AGENTS.md - Repository index (~100 lines) serving as map to knowledge base
• knowledge/design-docs/core-beliefs.md - Agent-centered development principles and "golden rules"
• knowledge/DESIGN.md - Design principles and architectural patterns
• knowledge/SECURITY.md - Security guidelines and requirements

Pattern Libraries

• knowledge/design-docs/agent-skills-patterns.md - Common structures and templates for skill development
• knowledge/design-docs/ai-development-patterns.md - AI/ML development patterns and best practices
• knowledge/design-docs/implementation-patterns.md - Reusable coding patterns and architectural templates
• knowledge/design-docs/coding-standards-compendium.md - Comprehensive coding guidelines across languages

Migration Guides

• knowledge/references/aspnetboilerplate-to-abp-migration-guide.md - Complete migration guide with code examples
• Framework Upgrades: Step-by-step upgrade instructions
• Best Practices: Modern development patterns and conventions

Framework Documentation

• knowledge/references/abp-io-framework-guide.md - Comprehensive ABP.IO framework documentation
• Architecture Patterns: DDD patterns and clean architecture principles
• Development Tools: CLI, Suite, and Studio usage guides

Planning & Quality

• knowledge/PLANS.md - Planning templates and methodology
• knowledge/PRODUCT_SENSE.md - Product principles and decision framework
• knowledge/QUALITY_SCORE.md - Quality metrics and scoring system
• knowledge/RELIABILITY.md - Reliability requirements and standards
• knowledge/exec-plans/tech-debt-tracker.md - Technical debt tracking

🎨 Featured Skills

Project Creation

• create-abp-project: ABP.IO project creation with template selection
• create-abp-io-template: Modern ABP.IO CLI-based template creation
• create-aspnetboilerplate-project: Traditional ASP.NET Boilerplate setup
• create-implementation-plan: Structured planning for development work
• create-github-action-workflow-specification: CI/CD workflow specifications

Code Generation & Best Practices

• csharp-async: C# async programming best practices
• csharp-developer: Full-stack C# development with .NET 10+, ASP.NET Core, Blazor, EF Core
• dotnet-best-practices: .NET coding standards and quality patterns
• modern-csharp-coding-standards: Modern C# 14 coding standards
• migrate-aspnetboilerplate-to-abp: Complete ASP.NET Boilerplate to ABP.IO migration
• github-issues: GitHub issue management automation
• web-design-reviewer: Web design review and optimization

Database & Data

• postgresql-code-review: PostgreSQL optimization strategies
• sql-optimization: SQL performance tuning patterns
• ef-core: Entity Framework Core best practices
• efcore-patterns: Advanced EF Core patterns and conventions

Harness Engineering

• harness-repo-structure: Create and maintain OpenAI-style repository structure
• harness-architecture: Rigid layered architecture with forward-only dependencies
• harness-quality-invariants: Quality invariants and golden rules for agent-generated code
• harness-no-yolo-probing: Strict prohibition of unvalidated data access

ABP Framework

• abp-angular: ABP Framework Angular patterns
• abp-core: ABP Core module development
• abp-ddd: Domain-Driven Design with ABP
• abp-ef-core: Entity Framework Core with ABP
• abp-testing: ABP testing patterns
• abp-microservice: ABP microservice architecture
• abp-multi-tenancy: Multi-tenancy patterns with ABP

Angular Development

• angular-component: Modern Angular standalone components
• angular-signals: Signal-based reactive patterns
• angular-forms: Reactive forms patterns
• angular-testing: Angular testing strategies
• angular-ssr: Server-side rendering with Angular

🔧 Configuration

IDE Integration

Each IDE has specific integration patterns:

• VS Code: ~/.github/skills, ~/.copilot/instructions
• Windsurf: ~/.windsurf/skills, ~/.windsurf/rules
• Cursor: ~/.cursor/skills, ~/.cursor/rules
• Devin: ~/.agents/skills, ~/.devin/skills, ~/.config/cognition/skills
• Claude: ~/.claude/skills, ~/.claude/rules
• Gemini: ~/.gemini/skills, ~/.gemini/GEMINI.md
• OpenClaw: ~/.openclaw/skills

Custom Rules

Rules are applied automatically based on file patterns:

applyTo: '**/*.cs,**/*.csproj,**/Program.cs,**/*.razor'

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Quick Contribution Steps

1. Fork the repository
2. Create a feature branch from main branch
3. Add your skill/rule/knowledge/agent/workflow
4. Submit a pull request to the main branch

Development Setup

# Clone repository
git clone https://github.com/your-username/agents-skills.git
cd agents-skills

# Validate your contribution
npm run skill:validate  # For skills
npm run plugin:validate  # For plugins (if applicable)

📖 Documentation

• AGENTS.md - Repository index and quick start guide (OpenAI harness engineering pattern)
• knowledge/design-docs/core-beliefs.md - Core principles and golden rules
• Contributing Guidelines - How to contribute to the project
• Code of Conduct - Community standards and guidelines
• Security Policy - Security policies and vulnerability reporting

🏆 Community

This is a community-driven project built with ❤️ by developers, for developers. Join us in:

• 🌟 Starring the repository to show your support
• 🍴 Forking and contributing your skills and knowledge
• 🐛 Reporting issues and suggesting features
• 📝 Improving documentation and sharing feedback
• 💬 Sharing your experiences and use cases
• 🤝 Helping others in the community

📊 Statistics

• Skills: 85+ specialized skills across various domains (including harness engineering)
• Rules: 107+ coding standards and best practices (including architecture rules)
• Workflows: 7+ agentic workflows for automation
• Knowledge: 23+ comprehensive guides and documents (restructured following OpenAI patterns)
• Frameworks: ASP.NET Boilerplate, ABP.IO, Angular, Blazor, and more
• Languages: C#, TypeScript, Python, PowerShell, and others
• IDE Support: VS Code, Windsurf, Cursor, Devin, Claude, Gemini, OpenClaw
• Utility Scripts: 3 system maintenance and cleanup scripts (clear-up-linux.sh com 20+ categorias de limpeza)

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Related Projects

• GitHub Copilot - AI pair programmer
• Agent Skills Specification - Skills standard
• Agentic Workflows - AI-powered repository automation
• MCP Protocol - Model Context Protocol for AI agents
• OpenAI Harness Engineering - Harness engineering principles
• Awesome Harness Engineering - Harness engineering resources

---

Built with ❤️ by the community, for the community.