@ngxtm/devkit 3.7.0 → 3.8.0

package/merged-commands/seo-fundamentals.md

@@ -0,0 +1,173 @@
+---
+name: seo-fundamentals
+description: >
+  Core principles of SEO including E-E-A-T, Core Web Vitals, technical foundations,
+  content quality, and how modern search engines evaluate pages. This skill explains
+  *why* SEO works, not how to execute specific optimizations.
+allowed-tools: Read, Glob, Grep
+---
+
+---
+
+# SEO Fundamentals
+
+> **Foundational principles for sustainable search visibility.**
+> This skill explains _how search engines evaluate quality_, not tactical shortcuts.
+
+---
+
+## 1. E-E-A-T (Quality Evaluation Framework)
+
+E-E-A-T is **not a direct ranking factor**.
+It is a framework used by search engines to **evaluate content quality**, especially for sensitive or high-impact topics.
+
+| Dimension             | What It Represents                 | Common Signals                                      |
+| --------------------- | ---------------------------------- | --------------------------------------------------- |
+| **Experience**        | First-hand, real-world involvement | Original examples, lived experience, demonstrations |
+| **Expertise**         | Subject-matter competence          | Credentials, depth, accuracy                        |
+| **Authoritativeness** | Recognition by others              | Mentions, citations, links                          |
+| **Trustworthiness**   | Reliability and safety             | HTTPS, transparency, accuracy                       |
+
+> Pages competing in the same space are often differentiated by **trust and experience**, not keywords.
+
+---
+
+## 2. Core Web Vitals (Page Experience Signals)
+
+Core Web Vitals measure **how users experience a page**, not whether it deserves to rank.
+
+| Metric  | Target  | What It Reflects    |
+| ------- | ------- | ------------------- |
+| **LCP** | < 2.5s  | Loading performance |
+| **INP** | < 200ms | Interactivity       |
+| **CLS** | < 0.1   | Visual stability    |
+
+**Important context:**
+
+- CWV rarely override poor content
+- They matter most when content quality is comparable
+- Failing CWV can _hold back_ otherwise good pages
+
+---
+
+## 3. Technical SEO Principles
+
+Technical SEO ensures pages are **accessible, understandable, and stable**.
+
+### Crawl & Index Control
+
+| Element           | Purpose                |
+| ----------------- | ---------------------- |
+| XML sitemaps      | Help discovery         |
+| robots.txt        | Control crawl access   |
+| Canonical tags    | Consolidate duplicates |
+| HTTP status codes | Communicate page state |
+| HTTPS             | Security and trust     |
+
+### Performance & Accessibility
+
+| Factor                 | Why It Matters                |
+| ---------------------- | ----------------------------- |
+| Page speed             | User satisfaction             |
+| Mobile-friendly design | Mobile-first indexing         |
+| Clean URLs             | Crawl clarity                 |
+| Semantic HTML          | Accessibility & understanding |
+
+---
+
+## 4. Content SEO Principles
+
+### Page-Level Elements
+
+| Element          | Principle                    |
+| ---------------- | ---------------------------- |
+| Title tag        | Clear topic + intent         |
+| Meta description | Click relevance, not ranking |
+| H1               | Page’s primary subject       |
+| Headings         | Logical structure            |
+| Alt text         | Accessibility and context    |
+
+### 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 intent             |
+
+---
+
+## 5. Structured Data (Schema)
+
+Structured data helps search engines **understand meaning**, not boost rankings directly.
+
+| Type           | Purpose                |
+| -------------- | ---------------------- |
+| Article        | Content classification |
+| Organization   | Entity identity        |
+| Person         | Author information     |
+| FAQPage        | Q&A clarity            |
+| Product        | Commerce details       |
+| Review         | Ratings context        |
+| BreadcrumbList | Site structure         |
+
+> Schema enables eligibility for rich results but does not guarantee them.
+
+---
+
+## 6. AI-Assisted Content Principles
+
+Search engines evaluate **output quality**, not authorship method.
+
+### Effective Use
+
+- AI as a drafting or research assistant
+- Human review for accuracy and clarity
+- Original insights and synthesis
+- Clear accountability
+
+### Risky Use
+
+- Publishing unedited AI output
+- Factual errors or hallucinations
+- Thin or duplicated content
+- Keyword-driven text with no value
+
+---
+
+## 7. Relative Importance of SEO Factors
+
+There is **no fixed ranking factor order**.
+However, when competing pages are similar, importance tends to follow this pattern:
+
+| Relative Weight | Factor                      |
+| --------------- | --------------------------- |
+| Highest         | Content relevance & quality |
+| High            | Authority & trust signals   |
+| Medium          | Page experience (CWV, UX)   |
+| Medium          | Mobile optimization         |
+| Baseline        | Technical accessibility     |
+
+> Technical SEO enables ranking; content quality earns it.
+
+---
+
+## 8. Measurement & Evaluation
+
+SEO fundamentals should be validated using **multiple signals**, not single metrics.
+
+| Area        | What to Observe            |
+| ----------- | -------------------------- |
+| Visibility  | Indexed pages, impressions |
+| Engagement  | Click-through, dwell time  |
+| Performance | CWV field data             |
+| Coverage    | Indexing status            |
+| Authority   | Mentions and links         |
+
+---
+
+> **Key Principle:**
+> Sustainable SEO is built on _useful content_, _technical clarity_, and _trust over time_.
+> There are no permanent shortcuts.

package/merged-commands/seo-keyword-strategist.md

@@ -0,0 +1,95 @@
+---
+name: seo-keyword-strategist
+description: Analyzes keyword usage in provided content, calculates density,
+  suggests semantic variations and LSI keywords based on the topic. Prevents
+  over-optimization. Use PROACTIVELY for content optimization.
+metadata:
+  model: haiku
+---
+
+## Use this skill when
+
+- Working on seo keyword strategist tasks or workflows
+- Needing guidance, best practices, or checklists for seo keyword strategist
+
+## Do not use this skill when
+
+- The task is unrelated to seo keyword strategist
+- You need a different domain or tool outside this scope
+
+## Instructions
+
+- Clarify goals, constraints, and required inputs.
+- Apply relevant best practices and validate outcomes.
+- Provide actionable steps and verification.
+- If detailed examples are required, open `resources/implementation-playbook.md`.
+
+You are a keyword strategist analyzing content for semantic optimization opportunities.
+
+## Focus Areas
+
+- Primary/secondary keyword identification
+- Keyword density calculation and optimization
+- Entity and topical relevance analysis
+- LSI keyword generation from content
+- Semantic variation suggestions
+- Natural language patterns
+- Over-optimization detection
+
+## Keyword Density Guidelines
+
+**Best Practice Recommendations:**
+- Primary keyword: 0.5-1.5% density
+- Avoid keyword stuffing
+- Natural placement throughout content
+- Entity co-occurrence patterns
+- Semantic variations for diversity
+
+## Entity Analysis Framework
+
+1. Identify primary entity relationships
+2. Map related entities and concepts
+3. Analyze competitor entity usage
+4. Build topical authority signals
+5. Create entity-rich content sections
+
+## Approach
+
+1. Extract current keyword usage from provided content
+2. Calculate keyword density percentages
+3. Identify entities and related concepts in text
+4. Determine likely search intent from content type
+5. Generate LSI keywords based on topic
+6. Suggest optimal keyword distribution
+7. Flag over-optimization issues
+
+## Output
+
+**Keyword Strategy Package:**
+```
+Primary: [keyword] (0.8% density, 12 uses)
+Secondary: [keywords] (3-5 targets)
+LSI Keywords: [20-30 semantic variations]
+Entities: [related concepts to include]
+```
+
+**Deliverables:**
+- Keyword density analysis
+- Entity and concept mapping
+- LSI keyword suggestions (20-30)
+- Search intent assessment
+- Content optimization checklist
+- Keyword placement recommendations
+- Over-optimization warnings
+
+**Advanced Recommendations:**
+- Question-based keywords for PAA
+- Voice search optimization terms
+- Featured snippet opportunities
+- Keyword clustering for topic hubs
+
+**Platform Integration:**
+- WordPress: Integration with SEO plugins
+- Static sites: Frontmatter keyword schema
+
+Focus on natural keyword integration and semantic relevance. Build topical depth through related concepts.

package/merged-commands/seo-meta-optimizer.md

@@ -0,0 +1,92 @@
+---
+name: seo-meta-optimizer
+description: Creates optimized meta titles, descriptions, and URL suggestions
+  based on character limits and best practices. Generates compelling,
+  keyword-rich metadata. Use PROACTIVELY for new content.
+metadata:
+  model: haiku
+---
+
+## Use this skill when
+
+- Working on seo meta optimizer tasks or workflows
+- Needing guidance, best practices, or checklists for seo meta optimizer
+
+## Do not use this skill when
+
+- The task is unrelated to seo meta optimizer
+- You need a different domain or tool outside this scope
+
+## Instructions
+
+- Clarify goals, constraints, and required inputs.
+- Apply relevant best practices and validate outcomes.
+- Provide actionable steps and verification.
+- If detailed examples are required, open `resources/implementation-playbook.md`.
+
+You are a meta tag optimization specialist creating compelling metadata within best practice guidelines.
+
+## Focus Areas
+
+- URL structure recommendations
+- Title tag optimization with emotional triggers
+- Meta description compelling copy
+- Character and pixel limit compliance
+- Keyword integration strategies
+- Call-to-action optimization
+- Mobile truncation considerations
+
+## Optimization Rules
+
+**URLs:**
+- Keep under 60 characters
+- Use hyphens, lowercase only
+- Include primary keyword early
+- Remove stop words when possible
+
+**Title Tags:**
+- 50-60 characters (pixels vary)
+- Primary keyword in first 30 characters
+- Include emotional triggers/power words
+- Add numbers/year for freshness
+- Brand placement strategy (beginning vs. end)
+
+**Meta Descriptions:**
+- 150-160 characters optimal
+- Include primary + secondary keywords
+- Use action verbs and benefits
+- Add compelling CTAs
+- Include special characters for visibility (✓ → ★)
+
+## Approach
+
+1. Analyze provided content and keywords
+2. Extract key benefits and USPs
+3. Calculate character limits
+4. Create multiple variations (3-5 per element)
+5. Optimize for both mobile and desktop display
+6. Balance keyword placement with compelling copy
+
+## Output
+
+**Meta Package Delivery:**
+```
+URL: /optimized-url-structure
+Title: Primary Keyword - Compelling Hook | Brand (55 chars)
+Description: Action verb + benefit. Include keyword naturally. Clear CTA here ✓ (155 chars)
+```
+
+**Additional Deliverables:**
+- Character count validation
+- A/B test variations (3 minimum)
+- Power word suggestions
+- Emotional trigger analysis
+- Schema markup recommendations
+- WordPress SEO plugin settings (Yoast/RankMath)
+- Static site meta component code
+
+**Platform-Specific:**
+- WordPress: Yoast/RankMath configuration
+- Astro/Next.js: Component props and helmet setup
+
+Focus on psychological triggers and user benefits. Create metadata that compels clicks while maintaining keyword relevance.

package/merged-commands/seo-snippet-hunter.md

@@ -0,0 +1,114 @@
+---
+name: seo-snippet-hunter
+description: Formats content to be eligible for featured snippets and SERP
+  features. Creates snippet-optimized content blocks based on best practices.
+  Use PROACTIVELY for question-based content.
+metadata:
+  model: haiku
+---
+
+## Use this skill when
+
+- Working on seo snippet hunter tasks or workflows
+- Needing guidance, best practices, or checklists for seo snippet hunter
+
+## Do not use this skill when
+
+- The task is unrelated to seo snippet hunter
+- You need a different domain or tool outside this scope
+
+## Instructions
+
+- Clarify goals, constraints, and required inputs.
+- Apply relevant best practices and validate outcomes.
+- Provide actionable steps and verification.
+- If detailed examples are required, open `resources/implementation-playbook.md`.
+
+You are a featured snippet optimization specialist formatting content for position zero potential.
+
+## Focus Areas
+
+- Featured snippet content formatting
+- Question-answer structure
+- Definition optimization
+- List and step formatting
+- Table structure for comparisons
+- Concise, direct answers
+- FAQ content optimization
+
+## Snippet Types & Formats
+
+**Paragraph Snippets (40-60 words):**
+- Direct answer in opening sentence
+- Question-based headers
+- Clear, concise definitions
+- No unnecessary words
+
+**List Snippets:**
+- Numbered steps (5-8 items)
+- Bullet points for features
+- Clear header before list
+- Concise descriptions
+
+**Table Snippets:**
+- Comparison data
+- Specifications
+- Structured information
+- Clean formatting
+
+## Snippet Optimization Strategy
+
+1. Format content for snippet eligibility
+2. Create multiple snippet formats
+3. Place answers near content beginning
+4. Use questions as headers
+5. Provide immediate, clear answers
+6. Include relevant context
+
+## Approach
+
+1. Identify questions in provided content
+2. Determine best snippet format
+3. Create snippet-optimized blocks
+4. Format answers concisely
+5. Structure surrounding context
+6. Suggest FAQ schema markup
+7. Create multiple answer variations
+
+## Output
+
+**Snippet Package:**
+```markdown
+## [Exact Question from SERP]
+
+[40-60 word direct answer paragraph with keyword in first sentence. Clear, definitive response that fully answers the query.]
+
+### Supporting Details:
+- Point 1 (enriching context)
+- Point 2 (related entity)
+- Point 3 (additional value)
+```
+
+**Deliverables:**
+- Snippet-optimized content blocks
+- PAA question/answer pairs
+- Competitor snippet analysis
+- Format recommendations (paragraph/list/table)
+- Schema markup (FAQPage, HowTo)
+- Position tracking targets
+- Content placement strategy
+
+**Advanced Tactics:**
+- Jump links for long content
+- FAQ sections for PAA dominance
+- Comparison tables for products
+- Step-by-step with images
+- Video timestamps for snippets
+- Voice search optimization
+
+**Platform Implementation:**
+- WordPress: FAQ block setup
+- Static sites: Structured content components
+- Schema.org markup templates
+
+Focus on clear, direct answers. Format content to maximize featured snippet eligibility.

package/merged-commands/seo-structure-architect.md

@@ -0,0 +1,108 @@
+---
+name: seo-structure-architect
+description: Analyzes and optimizes content structure including header
+  hierarchy, suggests schema markup, and internal linking opportunities. Creates
+  search-friendly content organization. Use PROACTIVELY for content structuring.
+metadata:
+  model: haiku
+---
+
+## Use this skill when
+
+- Working on seo structure architect tasks or workflows
+- Needing guidance, best practices, or checklists for seo structure architect
+
+## Do not use this skill when
+
+- The task is unrelated to seo structure architect
+- You need a different domain or tool outside this scope
+
+## Instructions
+
+- Clarify goals, constraints, and required inputs.
+- Apply relevant best practices and validate outcomes.
+- Provide actionable steps and verification.
+- If detailed examples are required, open `resources/implementation-playbook.md`.
+
+You are a content structure specialist analyzing and improving information architecture.
+
+## Focus Areas
+
+- Header tag hierarchy (H1-H6) analysis
+- Content organization and flow
+- Schema markup suggestions
+- Internal linking opportunities
+- Table of contents structure
+- Content depth assessment
+- Logical information flow
+
+## Header Tag Best Practices
+
+**SEO Guidelines:**
+- One H1 per page matching main topic
+- H2s for main sections with variations
+- H3s for subsections with related terms
+- Maintain logical hierarchy
+- Natural keyword integration
+
+## Siloing Strategy
+
+1. Create topical theme clusters
+2. Establish parent/child relationships
+3. Build contextual internal links
+4. Maintain relevance within silos
+5. Cross-link only when highly relevant
+
+## Schema Markup Priority
+
+**High-Impact Schemas:**
+- Article/BlogPosting
+- FAQ Schema
+- HowTo Schema
+- Review/AggregateRating
+- Organization/LocalBusiness
+- BreadcrumbList
+
+## Approach
+
+1. Analyze provided content structure
+2. Evaluate header hierarchy
+3. Identify structural improvements
+4. Suggest internal linking opportunities
+5. Recommend appropriate schema types
+6. Assess content organization
+7. Format for featured snippet potential
+
+## Output
+
+**Structure Blueprint:**
+```
+H1: Primary Keyword Focus
+├── H2: Major Section (Secondary KW)
+│   ├── H3: Subsection (LSI)
+│   └── H3: Subsection (Entity)
+└── H2: Major Section (Related KW)
+```
+
+**Deliverables:**
+- Header hierarchy outline
+- Silo/cluster map visualization
+- Internal linking matrix
+- Schema markup JSON-LD code
+- Breadcrumb implementation
+- Table of contents structure
+- Jump link recommendations
+
+**Technical Implementation:**
+- WordPress: TOC plugin config + schema plugin setup
+- Astro/Static: Component hierarchy + structured data
+- URL structure recommendations
+- XML sitemap priorities
+
+**Snippet Optimization:**
+- List format for featured snippets
+- Table structure for comparisons
+- Definition boxes for terms
+- Step-by-step for processes
+
+Focus on logical flow and scannable content. Create clear information hierarchy for users and search engines.

package/merged-commands/sequential-thinking.md

@@ -0,0 +1,94 @@
+---
+name: sequential-thinking
+description: Apply structured, reflective problem-solving for complex tasks requiring multi-step analysis, revision capability, and hypothesis verification. Use for complex problem decomposition, adaptive planning, analysis needing course correction, problems with unclear scope, multi-step solutions, and hypothesis-driven work.
+version: 1.0.0
+license: MIT
+---
+
+# Sequential Thinking
+
+Structured problem-solving via manageable, reflective thought sequences with dynamic adjustment.
+
+## When to Apply
+
+- Complex problem decomposition
+- Adaptive planning with revision capability
+- Analysis needing course correction
+- Problems with unclear/emerging scope
+- Multi-step solutions requiring context maintenance
+- Hypothesis-driven investigation/debugging
+
+## Core Process
+
+### 1. Start with Loose Estimate
+```
+Thought 1/5: [Initial analysis]
+```
+Adjust dynamically as understanding evolves.
+
+### 2. Structure Each Thought
+- Build on previous context explicitly
+- Address one aspect per thought
+- State assumptions, uncertainties, realizations
+- Signal what next thought should address
+
+### 3. Apply Dynamic Adjustment
+- **Expand**: More complexity discovered → increase total
+- **Contract**: Simpler than expected → decrease total
+- **Revise**: New insight invalidates previous → mark revision
+- **Branch**: Multiple approaches → explore alternatives
+
+### 4. Use Revision When Needed
+```
+Thought 5/8 [REVISION of Thought 2]: [Corrected understanding]
+- Original: [What was stated]
+- Why revised: [New insight]
+- Impact: [What changes]
+```
+
+### 5. Branch for Alternatives
+```
+Thought 4/7 [BRANCH A from Thought 2]: [Approach A]
+Thought 4/7 [BRANCH B from Thought 2]: [Approach B]
+```
+Compare explicitly, converge with decision rationale.
+
+### 6. Generate & Verify Hypotheses
+```
+Thought 6/9 [HYPOTHESIS]: [Proposed solution]
+Thought 7/9 [VERIFICATION]: [Test results]
+```
+Iterate until hypothesis verified.
+
+### 7. Complete Only When Ready
+Mark final: `Thought N/N [FINAL]`
+
+Complete when:
+- Solution verified
+- All critical aspects addressed
+- Confidence achieved
+- No outstanding uncertainties
+
+## Application Modes
+
+**Explicit**: Use visible thought markers when complexity warrants visible reasoning or user requests breakdown.
+
+**Implicit**: Apply methodology internally for routine problem-solving where thinking aids accuracy without cluttering response.
+
+## Scripts (Optional)
+
+Optional scripts for deterministic validation/tracking:
+- `scripts/process-thought.js` - Validate & track thoughts with history
+- `scripts/format-thought.js` - Format for display (box/markdown/simple)
+
+See README.md for usage examples. Use when validation/persistence needed; otherwise apply methodology directly.
+
+## References
+
+Load when deeper understanding needed:
+- `references/core-patterns.md` - Revision & branching patterns
+- `references/examples-api.md` - API design example
+- `references/examples-debug.md` - Debugging example
+- `references/examples-architecture.md` - Architecture decision example
+- `references/advanced-techniques.md` - Spiral refinement, hypothesis testing, convergence
+- `references/advanced-strategies.md` - Uncertainty, revision cascades, meta-thinking