Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions skills/architecture-review/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# Architecture Review

Review system architecture for scalability, maintainability, and best practices. Analyzes code structure, dependencies, data flow, and provides recommendations for improvements.

## Triggers

- `/architecture-review`
- `/arch-review`

## What It Does

1. Maps system components and dependencies
2. Identifies architectural patterns and anti-patterns
3. Evaluates scalability, maintainability, and security
4. Provides prioritized improvement recommendations
58 changes: 58 additions & 0 deletions skills/architecture-review/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
---
name: architecture-review
description: Review system architecture for scalability, maintainability, and best practices. Analyzes code structure, dependencies, data flow, and provides recommendations for improvements.
triggers:
- /architecture-review
- /arch-review
---

# Architecture Review

Evaluate system architecture and provide actionable recommendations for improvement.

## Process

1. **Map the system**: Understand components, dependencies, and data flow
2. **Identify patterns**: Recognize architectural patterns and anti-patterns
3. **Assess qualities**: Evaluate scalability, maintainability, testability, security
4. **Provide recommendations**: Suggest concrete improvements with trade-offs

## Review Areas

### Code Organization
- Module boundaries and cohesion
- Dependency direction and coupling
- Layer separation (presentation, business, data)
- Package structure and naming

### Scalability
- Horizontal vs vertical scaling considerations
- Stateless design patterns
- Caching strategies
- Database design and query patterns

### Maintainability
- Code complexity and readability
- Technical debt hotspots
- Test coverage and testability
- Documentation completeness

### Security Architecture
- Authentication and authorization patterns
- Data protection and encryption
- Network security boundaries
- Secret management

### Operational Concerns
- Observability (logging, metrics, tracing)
- Error handling and resilience
- Deployment and rollback strategies
- Configuration management

## Output Format

Provide:
1. **Architecture diagram** (if helpful)
2. **Strengths**: What the architecture does well
3. **Concerns**: Issues that should be addressed
4. **Recommendations**: Prioritized list of improvements with effort estimates
22 changes: 22 additions & 0 deletions skills/architecture-review/commands/architecture-review.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# /architecture-review

Review the architecture of a codebase.

## Usage

```
/architecture-review
/architecture-review --focus <scalability|security|maintainability>
```

## Examples

```
/architecture-review
```
Performs a comprehensive architecture review.

```
/architecture-review --focus scalability
```
Focuses on scalability concerns and recommendations.
17 changes: 17 additions & 0 deletions skills/audit-accessibility/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
# Audit Accessibility

Audit web applications for accessibility compliance with WCAG guidelines. Identifies barriers for users with disabilities and provides fixes to improve inclusivity.

## Triggers

- `/audit-accessibility`
- `/a11y-audit`
- `/wcag-check`

## What It Does

1. Scans for common accessibility violations
2. Checks keyboard navigation and focus management
3. Verifies ARIA usage and screen reader compatibility
4. Reports issues with WCAG references
5. Provides code fixes for identified issues
85 changes: 85 additions & 0 deletions skills/audit-accessibility/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,85 @@
---
name: audit-accessibility
description: Audit web applications for accessibility compliance with WCAG guidelines. Identifies barriers for users with disabilities and provides fixes to improve inclusivity.
triggers:
- /audit-accessibility
- /a11y-audit
- /wcag-check
---

# Audit Accessibility

Ensure web applications are accessible to users with disabilities.

## Process

1. **Automated checks**: Scan for common accessibility violations
2. **Manual review**: Assess keyboard navigation, screen reader compatibility
3. **Report issues**: Catalog violations with WCAG references
4. **Implement fixes**: Provide code changes to resolve issues

## WCAG Compliance Areas

### Perceivable
- Images have alt text
- Videos have captions
- Color is not the only indicator
- Sufficient color contrast
- Text can be resized

### Operable
- All functionality keyboard accessible
- Focus indicators visible
- No keyboard traps
- Skip navigation links
- Sufficient time limits

### Understandable
- Language declared
- Consistent navigation
- Clear error messages
- Form labels and instructions

### Robust
- Valid HTML markup
- ARIA used correctly
- Compatible with assistive technologies

## Common Issues

### Missing or Poor Alt Text
```html
<!-- Bad -->
<img src="chart.png">

<!-- Good -->
<img src="chart.png" alt="Sales increased 25% from Q1 to Q2">
```

### Insufficient Color Contrast
- Text must have 4.5:1 contrast ratio (normal text)
- Large text needs 3:1 ratio

### Missing Form Labels
```html
<!-- Bad -->
<input type="email" placeholder="Email">

<!-- Good -->
<label for="email">Email</label>
<input type="email" id="email">
```

### Non-Keyboard Accessible
- onClick without onKeyDown
- Custom controls without keyboard support
- Missing tabIndex for interactive elements

## Output Format

For each issue:
1. **Severity**: Critical, Serious, Moderate, Minor
2. **WCAG Criterion**: e.g., 1.1.1 Non-text Content
3. **Location**: Component/element affected
4. **Description**: What the issue is
5. **Fix**: Code change to resolve the issue
23 changes: 23 additions & 0 deletions skills/audit-accessibility/commands/audit-accessibility.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
# /audit-accessibility

Audit for accessibility compliance.

## Usage

```
/audit-accessibility
/audit-accessibility <component-or-page>
/audit-accessibility --level <A|AA|AAA>
```

## Examples

```
/audit-accessibility
```
Audits the entire frontend for accessibility issues.

```
/audit-accessibility src/components/Form.tsx
```
Audits a specific component.
16 changes: 16 additions & 0 deletions skills/clean-logs/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# Clean Up Logs

Analyze and improve application logging by removing noise, standardizing formats, adding structured context, and ensuring appropriate log levels.

## Triggers

- `/clean-logs`
- `/improve-logging`

## What It Does

1. Audits existing log statements
2. Fixes incorrect log levels
3. Adds missing context (correlation IDs, user info)
4. Removes noisy or redundant logs
5. Standardizes log format
54 changes: 54 additions & 0 deletions skills/clean-logs/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
---
name: clean-logs
description: Analyze and improve application logging by removing noise, standardizing formats, adding structured context, and ensuring appropriate log levels.
triggers:
- /clean-logs
- /improve-logging
---

# Clean Up Logs

Improve application logging for better observability and debugging.

## Process

1. **Audit current logging**: Review existing log statements
2. **Identify issues**: Find noise, missing context, incorrect levels
3. **Standardize**: Apply consistent formatting and structure
4. **Add context**: Include relevant debugging information
5. **Remove noise**: Eliminate unnecessary or redundant logs

## Common Issues

### Log Level Problems
- Debug logs in production code paths
- Errors logged as warnings (or vice versa)
- Info logs that should be debug
- Missing error logs for failure cases

### Missing Context
- Logs without request/correlation IDs
- Error logs without stack traces
- Missing user or session context
- No timing information for slow operations

### Noise and Redundancy
- Excessive logging in hot paths
- Duplicate log messages
- Logging sensitive data (PII, credentials)
- Logs that don't aid debugging

### Format Issues
- Inconsistent log formats
- Unstructured logs that are hard to parse
- Missing timestamps
- Non-standard field names

## Best Practices

- Use structured logging (JSON format)
- Include correlation IDs for request tracing
- Log at appropriate levels (ERROR, WARN, INFO, DEBUG)
- Redact sensitive information
- Include relevant context (user, request, operation)
- Make logs grep-able and queryable
22 changes: 22 additions & 0 deletions skills/clean-logs/commands/clean-logs.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# /clean-logs

Improve application logging quality.

## Usage

```
/clean-logs
/clean-logs <file-or-directory>
```

## Examples

```
/clean-logs
```
Reviews and improves logging across the codebase.

```
/clean-logs src/api/
```
Focuses on logging in the API directory.
17 changes: 17 additions & 0 deletions skills/cobol-modernization/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
# COBOL Modernization

Understand, document, and modernize legacy COBOL systems. Analyzes COBOL code, extracts business logic, generates documentation, and assists with migration to modern languages.

## Triggers

- `/modernize-cobol`
- `/cobol-to-java`
- `/analyze-cobol`

## What It Does

1. Analyzes COBOL program structure and copybooks
2. Extracts and documents business rules
3. Generates comprehensive documentation
4. Plans and executes migration to modern languages
5. Validates transformations preserve behavior
Loading
Loading