@neyugn/agent-kits 0.5.1 → 0.5.4

package/kits/coder/skills/seo-patterns/SKILL.md

@@ -8,19 +8,27 @@ priority: MEDIUM
 
 # SEO Patterns - Sustainable Search Visibility
 
-> **Philosophy:** Technical SEO enables ranking; content quality earns it. There are no permanent shortcuts.
+## ⚡ Quick Reference
+
+- **Core Web Vitals**: LCP < 2.5s · INP < 200ms · CLS < 0.1 · Monitor with Search Console
+- **HTML structure**: 1 `<h1>` per page · logical `<h2>→<h6>` · semantic tags (`<article>`, `<nav>`, `<main>`)
+- **Meta tags**: Unique `<title>` (50-60 chars) · `<meta description>` (150-160 chars) · `<canonical>`
+- **Images**: `alt` on all images · Next-gen format (WebP/AVIF) · `width` + `height` to prevent CLS  
+- **Structured data**: JSON-LD format · `Organization`, `Product`, `Article` schemas per content type
+- **Tech SEO**: `robots.txt` · `sitemap.xml` · HTTPS · Mobile-first · No render-blocking resources
+
+---
+
 
 ---
 
 ## 🎯 Core Principles
 
-| Principle             | Rule                                              |
-| --------------------- | ------------------------------------------------- |
-| **Content First**     | Quality content is the foundation of all SEO      |
-| **Technical Clarity** | Search engines must access, understand, and index |
-| **User Focus**        | Optimize for users, not search engines            |
-| **E-E-A-T**           | Experience, Expertise, Authoritativeness, Trust   |
-| **Patience**          | SEO is a long-term investment, not quick wins     |
+- **Content First**: Quality content is the foundation of all SEO
+- **Technical Clarity**: Search engines must access, understand, and index
+- **User Focus**: Optimize for users, not search engines
+- **E-E-A-T**: Experience, Expertise, Authoritativeness, Trust
+- **Patience**: SEO is a long-term investment, not quick wins
 
 ```
 ❌ WRONG: Keyword stuffing, link farms, AI spam
@@ -61,11 +69,9 @@ High E-E-A-T requirements for content affecting:
 
 ### Improvement Strategies
 
-| Metric | Quick Wins                                    |
-| ------ | --------------------------------------------- |
-| LCP    | Optimize images, preload critical resources   |
-| INP    | Reduce JavaScript, defer non-critical scripts |
-| CLS    | Set explicit dimensions on images/embeds      |
+- LCP: Optimize images, preload critical resources
+- INP: Reduce JavaScript, defer non-critical scripts
+- CLS: Set explicit dimensions on images/embeds
 
 ---
 
@@ -109,25 +115,21 @@ Sitemap: https://example.com/sitemap.xml
 
 ### On-Page Elements
 
-| Element              | Principle                       |
-| -------------------- | ------------------------------- |
-| **Title Tag**        | Clear topic + intent            |
-| **Meta Description** | Click relevance, not ranking    |
-| **H1**               | Page's primary subject          |
-| **Headings (H2-H6)** | Logical structure               |
-| **Alt Text**         | Accessibility and context       |
-| **Internal Links**   | Topic clusters, related content |
+- **Title Tag**: Clear topic + intent
+- **Meta Description**: Click relevance, not ranking
+- **H1**: Page's primary subject
+- **Headings (H2-H6)**: Logical structure
+- **Alt Text**: Accessibility and context
+- **Internal Links**: Topic clusters, related content
 
 ### Content Quality Signals
 
-| Dimension       | What Search Engines Look For |
-| --------------- | ---------------------------- |
-| **Depth**       | Fully answers the query      |
-| **Originality** | Adds unique value            |
-| **Accuracy**    | Factually correct            |
-| **Clarity**     | Easy to understand           |
-| **Usefulness**  | Satisfies user intent        |
-| **Freshness**   | Updated when relevant        |
+- **Depth**: Fully answers the query
+- **Originality**: Adds unique value
+- **Accuracy**: Factually correct
+- **Clarity**: Easy to understand
+- **Usefulness**: Satisfies user intent
+- **Freshness**: Updated when relevant
 
 ---
 
@@ -155,15 +157,13 @@ Sitemap: https://example.com/sitemap.xml
 
 ### Common Schema Types
 
-| Type               | Use Case                        |
-| ------------------ | ------------------------------- |
-| **Article**        | Blog posts, news articles       |
-| **Product**        | E-commerce product pages        |
-| **FAQPage**        | FAQ sections                    |
-| **BreadcrumbList** | Site navigation structure       |
-| **Organization**   | Company/brand identity          |
-| **LocalBusiness**  | Local businesses with locations |
-| **HowTo**          | Step-by-step guides             |
+- **Article**: Blog posts, news articles
+- **Product**: E-commerce product pages
+- **FAQPage**: FAQ sections
+- **BreadcrumbList**: Site navigation structure
+- **Organization**: Company/brand identity
+- **LocalBusiness**: Local businesses with locations
+- **HowTo**: Step-by-step guides
 
 ---
 
@@ -189,14 +189,12 @@ Search engines evaluate **output quality**, not authorship method.
 
 ## 📈 SEO Measurement
 
-| Area            | Key Metrics                     |
-| --------------- | ------------------------------- |
-| **Visibility**  | Indexed pages, impressions      |
-| **Rankings**    | Position changes, serp features |
-| **Traffic**     | Organic sessions, new pages     |
-| **Engagement**  | CTR, dwell time, bounce rate    |
-| **Conversions** | Organic-attributed conversions  |
-| **Technical**   | Core Web Vitals, crawl errors   |
+- **Visibility**: Indexed pages, impressions
+- **Rankings**: Position changes, serp features
+- **Traffic**: Organic sessions, new pages
+- **Engagement**: CTR, dwell time, bounce rate
+- **Conversions**: Organic-attributed conversions
+- **Technical**: Core Web Vitals, crawl errors
 
 ### Essential Tools
 
@@ -209,16 +207,14 @@ Search engines evaluate **output quality**, not authorship method.
 
 ## 🚨 SEO Anti-Patterns
 
-| ❌ Don't                   | ✅ Do                              |
-| -------------------------- | ---------------------------------- |
-| Keyword stuffing           | Natural language, topic coverage   |
-| Duplicate content          | Canonical tags, unique pages       |
-| Hidden text/links          | Visible, accessible content        |
-| Low-quality link building  | Earn links through quality content |
-| Ignore mobile              | Mobile-first design                |
-| Block CSS/JS from crawlers | Allow full page rendering          |
-| Slow page load             | Optimize Core Web Vitals           |
-| Missing alt text           | Descriptive alt for all images     |
+- Keyword stuffing: Natural language, topic coverage
+- Duplicate content: Canonical tags, unique pages
+- Hidden text/links: Visible, accessible content
+- Low-quality link building: Earn links through quality content
+- Ignore mobile: Mobile-first design
+- Block CSS/JS from crawlers: Allow full page rendering
+- Slow page load: Optimize Core Web Vitals
+- Missing alt text: Descriptive alt for all images
 
 ---
 
@@ -250,12 +246,10 @@ Search engines evaluate **output quality**, not authorship method.
 
 ## 🔗 Related Skills
 
-| Need                     | Skill                     |
-| ------------------------ | ------------------------- |
-| Performance optimization | `performance-profiling`   |
-| Accessibility            | `accessibility-patterns`  |
-| React/Next.js SSR        | `react-patterns`          |
-| Content structure        | `documentation-templates` |
+- Performance optimization: `performance-profiling`
+- Accessibility: `accessibility-patterns`
+- React/Next.js SSR: `react-patterns`
+- Content structure: `documentation-templates`
 
 ---
 

package/kits/coder/skills/systematic-debugging/SKILL.md

@@ -6,7 +6,16 @@ allowed-tools: Read, Write, Edit, Bash, Grep
 
 # Systematic Debugging - Scientific Defect Resolution
 
-> **Philosophy:** Debugging is detective work. Gather evidence, form hypotheses, test systematically.
+## ⚡ Quick Reference
+
+- **4 phases**: Reproduce → Isolate → Root Cause (5 Whys) → Fix + Regression Test
+- **Never guess**: Profile first · Read the full stack trace · Binary search commits with `git bisect`
+- **Reproduce first**: Can't fix what you can't see · Get exact steps · Note env differences
+- **Root cause**: Ask WHY 5 times · Fix cause not symptom · Symptom recurs if only patched
+- **After fix**: Add regression test · Check similar code · Remove debug logs · Document root cause
+
+---
+
 
 ---
 
@@ -86,13 +95,11 @@ PHASE 4: VERIFY        → Confirm fix, prevent regression
 
 ### Handling Intermittent Bugs
 
-| Pattern              | Investigation Approach                  |
-| -------------------- | --------------------------------------- |
-| Race condition       | Add timing logs, check for async issues |
-| Memory-related       | Check for uninitialized variables       |
-| State-dependent      | Log state at failure points             |
-| Environment-specific | Compare configurations                  |
-| Load-dependent       | Test under high load/concurrency        |
+- Race condition: Add timing logs, check for async issues
+- Memory-related: Check for uninitialized variables
+- State-dependent: Log state at failure points
+- Environment-specific: Compare configurations
+- Load-dependent: Test under high load/concurrency
 
 ### If Bug Won't Reproduce
 
@@ -229,13 +236,11 @@ PHASE 4: VERIFY        → Confirm fix, prevent regression
 
 ### Fix Quality Criteria
 
-| Criterion      | Description                             |
-| -------------- | --------------------------------------- |
-| **Targeted**   | Changes only what's necessary           |
-| **Root-Cause** | Fixes the cause, not the symptom        |
-| **Safe**       | Doesn't introduce new bugs              |
-| **Readable**   | Future developers can understand why    |
-| **Testable**   | Can verify it works with automated test |
+- **Targeted**: Changes only what's necessary
+- **Root-Cause**: Fixes the cause, not the symptom
+- **Safe**: Doesn't introduce new bugs
+- **Readable**: Future developers can understand why
+- **Testable**: Can verify it works with automated test
 
 ### Fix Documentation
 
@@ -265,14 +270,12 @@ PHASE 4: VERIFY        → Confirm fix, prevent regression
 
 ### Common Fix Patterns
 
-| Bug Type         | Fix Pattern                             |
-| ---------------- | --------------------------------------- |
-| Null reference   | Add null check + handle gracefully      |
-| Race condition   | Add synchronization/locking             |
-| Off-by-one       | Adjust boundary condition               |
-| State corruption | Reset or validate state at entry points |
-| Memory leak      | Ensure resources are cleaned up         |
-| Timeout          | Adjust timeout + add retry logic        |
+- Null reference: Add null check + handle gracefully
+- Race condition: Add synchronization/locking
+- Off-by-one: Adjust boundary condition
+- State corruption: Reset or validate state at entry points
+- Memory leak: Ensure resources are cleaned up
+- Timeout: Adjust timeout + add retry logic
 
 ---
 
@@ -390,16 +393,14 @@ Step 4: Repeat until bug location is isolated
 
 ## 🚨 Anti-Patterns
 
-| ❌ Don't                   | ✅ Do                                       |
-| -------------------------- | ------------------------------------------- |
-| Change random things       | Test one hypothesis at a time               |
-| Fix the symptom            | Find and fix root cause                     |
-| Skip reproduction          | Establish reliable repro first              |
-| Hope it's fixed            | Verify with tests                           |
-| Fix and forget             | Document and add regression test            |
-| Debug in production        | Reproduce in safe environment when possible |
-| Remove code until it works | Understand why code was there               |
-| Assume the obvious cause   | Test each hypothesis with evidence          |
+- Change random things: Test one hypothesis at a time
+- Fix the symptom: Find and fix root cause
+- Skip reproduction: Establish reliable repro first
+- Hope it's fixed: Verify with tests
+- Fix and forget: Document and add regression test
+- Debug in production: Reproduce in safe environment when possible
+- Remove code until it works: Understand why code was there
+- Assume the obvious cause: Test each hypothesis with evidence
 
 ---
 
@@ -466,12 +467,10 @@ Step 4: Repeat until bug location is isolated
 
 ## 🔗 Related Skills
 
-| Need                     | Skill              |
-| ------------------------ | ------------------ |
-| Understanding before fix | `brainstorming`    |
-| Planning complex fixes   | `plan-writing`     |
-| Writing regression tests | `testing-patterns` |
-| Clean fix code           | `clean-code`       |
+- Understanding before fix: `brainstorming`
+- Planning complex fixes: `plan-writing`
+- Writing regression tests: `testing-patterns`
+- Clean fix code: `clean-code`
 
 ---
 

package/kits/coder/skills/tailwind-patterns/SKILL.md

@@ -6,6 +6,18 @@ allowed-tools: Read, Write, Edit, Glob, Grep, Bash
 
 # Tailwind CSS Patterns
 
+## ⚡ Quick Reference
+
+- **Design tokens**: Use `@theme` variables not arbitrary values · consistent scale (spacing-4 = 1rem)
+- **Components**: `@apply` for repeated patterns · prefer component extraction over long class strings  
+- **Responsive**: Mobile-first · `sm:` `md:` `lg:` breakpoints · `container mx-auto px-4` base
+- **Dark mode**: `dark:` prefix · `class` strategy for user toggle · respect `prefers-color-scheme`
+- **Performance**: PurgeCSS included · JIT compiles only used classes · no custom CSS without reason
+- **Avoid**: Arbitrary values `[px]` in prod code · Inline styles alongside Tailwind · Premature abstraction
+
+---
+
+
 > Utility-first CSS that actually scales.
 
 ---
@@ -371,24 +383,20 @@ export function cn(...inputs: ClassValue[]) {
 
 ## ❌ Anti-Patterns
 
-| ❌ Don't                         | ✅ Do                            |
-| -------------------------------- | -------------------------------- |
-| `text-${color}-500` dynamic      | Map to complete class strings    |
-| Inline arbitrary values `[23px]` | Define in `@theme` and use token |
-| 20+ classes per element          | Extract component or @apply      |
-| `dark:` on every element         | Use CSS variables for colors     |
-| Skip focus states                | Include `focus-visible:ring-*`   |
+- `text-${color}-500` dynamic: Map to complete class strings
+- Inline arbitrary values `[23px]`: Define in `@theme` and use token
+- 20+ classes per element: Extract component or @apply
+- `dark:` on every element: Use CSS variables for colors
+- Skip focus states: Include `focus-visible:ring-*`
 
 ---
 
 ## 🔗 Related Skills
 
-| Need                     | Skill                    |
-| ------------------------ | ------------------------ |
-| React component patterns | `react-patterns`         |
-| Accessibility            | `accessibility-patterns` |
-| Design principles        | `frontend-design`        |
-| Performance              | `performance-profiling`  |
+- React component patterns: `react-patterns`
+- Accessibility: `accessibility-patterns`
+- Design principles: `frontend-design`
+- Performance: `performance-profiling`
 
 ---
 

package/kits/coder/skills/terraform-patterns/SKILL.md

@@ -8,19 +8,27 @@ priority: HIGH
 
 # Terraform Patterns - Infrastructure as Code Excellence
 
-> **Philosophy:** Infrastructure is code. Treat it with the same rigor as application code: version control, testing, code review, and automation.
+## ⚡ Quick Reference
+
+- **Workflow**: `terraform init` → `plan` (review!) → `apply` · Never apply without reviewing plan
+- **State**: Remote backend (S3+DynamoDB lock) · Never commit `.tfstate` to git
+- **Structure**: `main.tf` · `variables.tf` · `outputs.tf` · `versions.tf` · modules for reuse
+- **Variables**: Always typed with descriptions · sensitive = `sensitive = true` · no hardcoded values
+- **Modules**: Separate resources into modules · `source = "./modules/vpc"` · version-pinned remote modules
+- **Naming**: `resource "aws_instance" "web_server"` kebab-case · consistent tagging all resources
+
+---
+
 
 ---
 
 ## 🎯 Core Principles
 
-| Principle        | Rule                                                  |
-| ---------------- | ----------------------------------------------------- |
-| **Declarative**  | Describe desired state, not steps to achieve it       |
-| **Idempotent**   | Same code + same state = same result, every time      |
-| **Version-Able** | All infrastructure changes tracked in version control |
-| **Testable**     | Validate before apply, test after                     |
-| **Modular**      | Reusable components, single responsibility per module |
+- **Declarative**: Describe desired state, not steps to achieve it
+- **Idempotent**: Same code + same state = same result, every time
+- **Version-Able**: All infrastructure changes tracked in version control
+- **Testable**: Validate before apply, test after
+- **Modular**: Reusable components, single responsibility per module
 
 ```
 ❌ WRONG: Manual console changes → Export to code
@@ -59,15 +67,13 @@ infrastructure/
 
 ### File Organization
 
-| File               | Purpose                                 |
-| ------------------ | --------------------------------------- |
-| `main.tf`          | Primary resources                       |
-| `variables.tf`     | Input variables with descriptions       |
-| `outputs.tf`       | Output values                           |
-| `versions.tf`      | Provider/Terraform version constraints  |
-| `data.tf`          | Data sources (optional)                 |
-| `locals.tf`        | Local values (optional)                 |
-| `terraform.tfvars` | Environment-specific values (gitignore) |
+- `main.tf`: Primary resources
+- `variables.tf`: Input variables with descriptions
+- `outputs.tf`: Output values
+- `versions.tf`: Provider/Terraform version constraints
+- `data.tf`: Data sources (optional)
+- `locals.tf`: Local values (optional)
+- `terraform.tfvars`: Environment-specific values (gitignore)
 
 ---
 
@@ -232,13 +238,11 @@ terraform {
 
 ### State Security Checklist
 
-| Check                     | Implementation                     |
-| ------------------------- | ---------------------------------- |
-| **Encryption at rest**    | `encrypt = true` in backend        |
-| **Encryption in transit** | HTTPS/TLS always                   |
-| **Access control**        | IAM policies limiting state access |
-| **Versioning**            | S3 bucket versioning enabled       |
-| **Backup**                | Cross-region replication           |
+- **Encryption at rest**: `encrypt = true` in backend
+- **Encryption in transit**: HTTPS/TLS always
+- **Access control**: IAM policies limiting state access
+- **Versioning**: S3 bucket versioning enabled
+- **Backup**: Cross-region replication
 
 ---
 
@@ -307,13 +311,11 @@ tfsec .
 
 ### Security Rules
 
-| Rule                      | Implementation                         |
-| ------------------------- | -------------------------------------- |
-| **No secrets in code**    | Use secrets manager, not variables     |
-| **Pin provider versions** | `version = "~> 5.0"` not `>= 5.0`      |
-| **Enable encryption**     | Encryption at rest for all data stores |
-| **Least privilege IAM**   | Minimal permissions, no wildcards      |
-| **Private by default**    | No public IPs unless explicitly needed |
+- **No secrets in code**: Use secrets manager, not variables
+- **Pin provider versions**: `version = "~> 5.0"` not `>= 5.0`
+- **Enable encryption**: Encryption at rest for all data stores
+- **Least privilege IAM**: Minimal permissions, no wildcards
+- **Private by default**: No public IPs unless explicitly needed
 
 ### Sensitive Variables
 
@@ -415,16 +417,14 @@ version = ">= 5.0"     # Minimum (risky - breaking changes)
 
 ## 🚨 Anti-Patterns
 
-| ❌ Don't                         | ✅ Do                              |
-| -------------------------------- | ---------------------------------- |
-| Manual console changes           | All changes through code           |
-| Secrets in terraform.tfvars      | External secrets manager           |
-| Single state file for everything | Per-environment, per-stack states  |
-| `terraform apply` without plan   | Always review plan before apply    |
-| Hardcoded values                 | Variables with validation          |
-| `latest` provider versions       | Pinned versions with lock file     |
-| Massive monolithic modules       | Small, focused, composable modules |
-| Skip state locking               | Always enable locking              |
+- Manual console changes: All changes through code
+- Secrets in terraform.tfvars: External secrets manager
+- Single state file for everything: Per-environment, per-stack states
+- `terraform apply` without plan: Always review plan before apply
+- Hardcoded values: Variables with validation
+- `latest` provider versions: Pinned versions with lock file
+- Massive monolithic modules: Small, focused, composable modules
+- Skip state locking: Always enable locking
 
 ---
 
@@ -443,27 +443,23 @@ version = ">= 5.0"     # Minimum (risky - breaking changes)
 
 ## ✅ Self-Check Before Completing
 
-| Check                       | Question                                       |
-| --------------------------- | ---------------------------------------------- |
-| ✅ **Modules?**             | Is reusable logic extracted to modules?        |
-| ✅ **State remote?**        | State stored remotely with locking?            |
-| ✅ **Versions pinned?**     | Terraform and provider versions constrained?   |
-| ✅ **Variables validated?** | Input variables have description + validation? |
-| ✅ **Secrets safe?**        | No secrets in code or state?                   |
-| ✅ **Tested?**              | Plan reviewed, security scanned?               |
-| ✅ **Documented?**          | README for modules, examples provided?         |
+- ✅ **Modules?**: Is reusable logic extracted to modules?
+- ✅ **State remote?**: State stored remotely with locking?
+- ✅ **Versions pinned?**: Terraform and provider versions constrained?
+- ✅ **Variables validated?**: Input variables have description + validation?
+- ✅ **Secrets safe?**: No secrets in code or state?
+- ✅ **Tested?**: Plan reviewed, security scanned?
+- ✅ **Documented?**: README for modules, examples provided?
 
 ---
 
 ## 🔗 Related Skills
 
-| Need                    | Skill                 |
-| ----------------------- | --------------------- |
-| Container orchestration | `kubernetes-patterns` |
-| Docker builds           | `docker-patterns`     |
-| CI/CD workflows         | `github-actions`      |
-| Database design         | `database-design`     |
-| Cloud architecture      | Cloud provider docs   |
+- Container orchestration: `kubernetes-patterns`
+- Docker builds: `docker-patterns`
+- CI/CD workflows: `github-actions`
+- Database design: `database-design`
+- Cloud architecture: Cloud provider docs
 
 ---