@muskanmeet/invoicing-design-system 0.1.0

package/.local/secondary_skills/geo/references/content-patterns.md

@@ -0,0 +1,158 @@
+# GEO Content Patterns by Type
+
+Templates and structural patterns for creating GEO-optimized content across different content types.
+
+## Blog Posts and Articles
+
+### Structure
+
+1. **Opening paragraph** — State the core answer/thesis in the first 2 sentences. Include a key statistic if available.
+2. **Table of contents** — For posts over 1000 words, include a linked TOC. AI engines use these to understand topic scope.
+
+3. **Core sections** (H2s) — Each H2 should be a question or a clear topic phrase. Lead each section with its answer.
+4. **Supporting detail** — After the direct answer, provide context, examples, data, and nuance.
+
+5. **FAQ section** — End with 3-5 frequently asked questions in Q&A format. These are highly extractable by AI engines.
+6. **Summary/Key takeaways** — Bullet list of the main points. AI engines frequently pull from summary sections.
+
+### Example Opening
+
+```text
+
+## How Long Does It Take to Learn Python?
+
+Most beginners can learn Python basics in 2-4 weeks with consistent daily practice of 1-2 hours.
+
+Reaching intermediate proficiency typically takes 3-6 months, while advanced mastery requires
+
+1-2 years of hands-on project experience. According to a 2024 Stack Overflow survey, Python
+
+remains the most-wanted programming language, with 67% of developers who don't use it expressing
+
+interest in learning it.
+
+```
+
+## Product and Service Pages
+
+### Structure (2)
+
+1. **Product definition** — "X is a [category] that [primary function] for [target audience]."
+2. **Key features/benefits** — Bulleted list with one-line descriptions.
+
+3. **How it works** — Numbered steps or brief process explanation.
+4. **Pricing** (if applicable) — Clear pricing table or range. AI engines frequently cite pricing info.
+
+5. **Comparison to alternatives** — Brief positioning against known competitors or categories.
+6. **Use cases** — 2-3 specific scenarios with concrete details.
+
+7. **FAQ** — Common purchase/usage questions answered directly.
+
+### Key Principle
+
+Product pages often get skipped by AI engines because they read as marketing copy. Counter this by including factual, verifiable claims, specific numbers (dimensions, speeds, capacities), and honest comparisons. AI engines trust product pages that read like informed reviews more than ones that read like ads.
+
+## FAQ and Knowledge Base Pages
+
+### Structure (3)
+
+- Each question as an H2 or H3
+- Answer in the first sentence, explanation following
+
+- Use the exact phrasing people use when asking (natural language, not jargon)
+- Group related questions under topic headings
+
+- Include "Related questions" links between entries
+
+### Example
+
+```text
+
+## Can I return an opened product?
+
+Yes, opened products can be returned within 30 days of purchase for a full refund, provided
+
+they are in resalable condition with original packaging. Exceptions include perishable goods,
+
+personalized items, and digital downloads. To initiate a return, contact support@example.com
+
+or use the Returns portal in your account dashboard.
+
+```
+
+### Key Principle (2)
+
+FAQ pages are the highest-value GEO content type because they directly match question-answer patterns. Each Q&A pair is a self-contained unit that AI engines can extract whole. Write each answer as if it will be read without any surrounding context.
+
+## Technical Documentation
+
+### Structure (4)
+
+1. **Overview** — What the tool/API/feature does in 1-2 sentences.
+2. **Quick start** — Minimal steps to get running.
+
+3. **Detailed usage** — Organized by feature or use case.
+4. **Code examples** — Annotated, runnable code snippets.
+
+5. **Configuration reference** — Tables of parameters, options, defaults.
+6. **Troubleshooting** — Common errors and their solutions.
+
+7. **Changelog/Version notes** — What changed and when.
+
+### Key Principle (3)
+
+Technical docs get cited heavily by AI coding assistants. Make code examples copy-pasteable and self-contained. Include expected output. Use consistent parameter tables with columns: Name, Type, Default, Description. Date version references clearly.
+
+## Landing Pages
+
+### Structure (5)
+
+1. **Hero statement** — Clear value proposition in one sentence.
+2. **Problem/solution framing** — What problem you solve, stated concretely.
+
+3. **Social proof** — Named testimonials, client logos, specific metrics ("used by 10,000+ teams").
+4. **Feature highlights** — 3-5 key features with specific benefits.
+
+5. **How it works** — Simple 3-step explanation.
+6. **Pricing/CTA** — Clear next step.
+
+### Key Principle (4)
+
+Landing pages are harder to optimize for GEO because they are inherently promotional. Include enough factual, verifiable information (founding year, team size, concrete metrics, named clients) that AI engines can treat the page as a source of facts rather than just marketing.
+
+## Comparison and Review Pages
+
+### Structure (6)
+
+1. **Verdict up front** — State the recommendation in the opening.
+2. **Comparison table** — Side-by-side feature/price/spec comparison.
+
+3. **Category-by-category analysis** — Each criterion as its own section with a clear winner stated.
+4. **Use-case recommendations** — "Best for X: [Option A]. Best for Y: [Option B]."
+
+5. **Methodology** — Brief note on how you evaluated.
+6. **FAQ** — Common decision-making questions.
+
+### Key Principle (5)
+
+Comparison queries ("X vs Y", "best Z for W") are among the most common AI engine queries. AI engines love structured comparison content because it directly answers decision-making questions. Use tables generously. State clear opinions backed by specific criteria — AI engines cite decisive analysis, not fence-sitting.
+
+### Example Comparison Table
+
+```markdown
+
+| Feature | Tool A | Tool B | Tool C |
+
+|---------|--------|--------|--------|
+
+| Starting Price | $12/mo | $29/mo | Free |
+
+| Max Users | 10 | Unlimited | 5 |
+
+| API Access | Yes | Yes | No |
+
+| Mobile App | iOS only | iOS + Android | iOS + Android |
+
+| Best For | Small teams | Enterprise | Solo users |
+
+```

package/.local/secondary_skills/geo/references/platform-notes.md

@@ -0,0 +1,128 @@
+# Platform-Specific GEO Notes
+
+Each AI engine has different crawling, indexing, and citation behaviors. These notes help tailor optimization strategy by platform.
+
+## ChatGPT / OpenAI
+
+**Crawler:** `GPTBot`
+
+**How it finds content:**
+
+- Training data (periodic, large-scale ingestion)
+- Browsing tool (real-time web search when users ask current questions)
+
+- When browsing, ChatGPT uses Bing's search index as a starting point, then fetches and reads pages directly
+
+**Citation behavior:**
+
+- Provides inline citations with links when using the browsing tool
+- For training data responses, sources are not cited — the model synthesizes from memory
+
+- Tends to cite authoritative domains and well-structured content
+- Prefers content that provides clear, definitive answers over hedged language
+
+**Optimization priorities:**
+
+1. Ensure GPTBot is not blocked in robots.txt
+2. Focus on comprehensive, well-sourced content (training data quality)
+
+3. Strong meta descriptions and opening paragraphs (browsing tool extraction)
+4. FAQ-style content works well for direct question matching
+
+## Google AI Overviews (formerly SGE)
+
+**Crawler:** Standard `Googlebot` (plus `Google-Extended` for training)
+
+**How it finds content:**
+
+- Uses Google's existing search index as the primary source
+- AI Overviews appear above traditional search results for eligible queries
+
+- Traditional SEO signals (backlinks, domain authority, PageRank) still heavily influence which sources get cited in AI Overviews
+
+**Citation behavior:**
+
+- Shows source cards alongside the AI-generated answer
+- Typically cites 2-5 sources per overview
+
+- Strongly favors pages that already rank in the top 10 for the query
+- Uses structured data to enhance source cards (images, site name, breadcrumbs)
+
+**Optimization priorities:**
+
+1. Traditional SEO still matters heavily — domain authority, backlinks, and ranking position directly influence AI Overview citation
+2. Schema markup is more impactful here than other platforms because Google uses it to render rich source cards
+
+3. Content that matches Google's E-E-A-T guidelines (Experience, Expertise, Authoritativeness, Trustworthiness) gets preferential citation
+4. Heading-question alignment is critical — Google matches AI Overview sub-answers to page sections via headings
+
+## Perplexity AI
+
+**Crawler:** `PerplexityBot`
+
+**How it finds content:**
+
+- Real-time web crawling for every query (always fetches fresh content)
+- Indexes and caches frequently-cited sources
+
+- Also uses its own search index built from ongoing crawling
+
+**Citation behavior:**
+
+- Heavy citation model — almost every claim gets a numbered source reference
+- Cites the specific page (and sometimes section) that supports each claim
+
+- Prefers pages with clear, verifiable, specific information
+- Will cite multiple sources in a single answer, often 5-10+
+
+**Optimization priorities:**
+
+1. Freshness is critical — Perplexity crawls in real-time, so up-to-date content wins
+2. Ensure PerplexityBot is not blocked in robots.txt
+
+3. Specific, quotable statements with data points are highly cited
+4. Page load speed matters — Perplexity has crawl timeouts
+
+5. Content that covers niche sub-topics well gets cited for those specific sub-queries
+
+## Bing Copilot
+
+**Crawler:** Standard `Bingbot`
+
+**How it finds content:**
+
+- Uses Bing's search index
+- Real-time search + AI synthesis for each query
+
+- Microsoft's AI integration means Copilot answers appear across Bing, Edge, Windows, and Microsoft 365
+
+**Citation behavior:**
+
+- Inline numbered citations linking to source pages
+- Typically cites 3-6 sources per answer
+
+- Bing's index favors well-structured, authoritative content
+- Social signals and freshness can influence Bing ranking more than Google
+
+**Optimization priorities:**
+
+1. Submit site to Bing Webmaster Tools (separate from Google Search Console)
+2. Bing places slightly more weight on social signals and exact-match content
+
+3. Strong semantic HTML structure helps Bing's parser
+4. Clear authorship signals and organization info boost authority
+
+5. IndexNow protocol support can speed up Bing indexing of new/updated content
+
+## Cross-Platform Strategy
+
+Given that each platform has different strengths, a good cross-platform approach:
+
+1. **Don't block any AI crawlers** in robots.txt unless you have a specific reason
+2. **Maintain strong traditional SEO** — it directly feeds Google AI Overviews and influences Bing Copilot
+
+3. **Keep content fresh** — critical for Perplexity, helpful for all
+4. **Use schema markup** — highest impact on Google, but helps all platforms
+
+5. **Write quotable, self-contained statements** — this is the single most impactful practice across all AI engines
+6. **Submit to both Google Search Console and Bing Webmaster Tools** — covers the two major search indexes that AI engines rely on

package/.local/secondary_skills/geo/references/scorecard.md

@@ -0,0 +1,113 @@
+# GEO Audit Scorecard
+
+Use this checklist when evaluating existing content. Each category is scored out of 20 points for a total of 100.
+
+## 1. Direct Answerability (20 points)
+
+| Criterion | Points | What to Look For |
+
+|-----------|--------|------------------|
+
+| Lead with the answer | 5 | Does the content answer the primary query in the first 1-2 sentences of the relevant section? |
+
+| Quotable sentences | 5 | Are there self-contained, factual sentences that work as standalone quotes? Count how many key claims pass the "copy-paste into an AI answer" test. |
+
+| Query-intent match | 5 | Does the content match what someone actually searching this topic wants to know? (informational, transactional, navigational) |
+
+| Concise definitions | 5 | For definitional topics, is there a clear "X is..." statement? For how-to topics, are steps numbered and actionable? |
+
+### Scoring Guide
+
+- 0-5: Content buries answers, requires heavy inference
+- 6-10: Some direct answers but inconsistent
+
+- 11-15: Most key questions answered directly
+- 16-20: Every section leads with its answer, highly extractable
+
+## 2. Authority & Citations (20 points)
+
+| Criterion | Points | What to Look For |
+
+|-----------|--------|------------------|
+
+| Statistics and data | 5 | Are specific numbers, percentages, and data points included? Are they sourced? |
+
+| Expert attribution | 5 | Are claims attributed to named experts, organizations, or studies? |
+
+| Source diversity | 5 | Do citations come from multiple credible sources (not just one)? |
+
+| Recency of sources | 5 | Are cited data points and studies current (within 1-2 years for fast-moving topics)? |
+
+### Scoring Guide (2)
+
+- 0-5: No sources, all opinion
+- 6-10: Some statistics but mostly unsourced
+
+- 11-15: Good sourcing with minor gaps
+- 16-20: Comprehensive, well-sourced, diverse citations throughout
+
+## 3. Structure & Formatting (20 points)
+
+| Criterion | Points | What to Look For |
+
+|-----------|--------|------------------|
+
+| Heading hierarchy | 5 | Clear H1 > H2 > H3 progression? Do headings mirror natural queries? |
+
+| List and table usage | 5 | Are comparison data, steps, and options formatted as lists or tables instead of prose? |
+
+| Paragraph length | 5 | Are paragraphs 2-4 sentences? No walls of text? |
+
+| Scanability | 5 | Can someone (or an AI) find the answer to a specific sub-question by scanning headings alone? |
+
+### Scoring Guide (3)
+
+- 0-5: Wall of text, no clear structure
+- 6-10: Basic structure but inconsistent formatting
+
+- 11-15: Good structure with clear sections
+- 16-20: Excellent hierarchy, every section is scannable and parseable
+
+## 4. Topical Depth (20 points)
+
+| Criterion | Points | What to Look For |
+
+|-----------|--------|------------------|
+
+| Coverage breadth | 5 | Does the content address the full scope of the topic, including related questions? |
+
+| Specificity | 5 | Are there concrete examples, case studies, specific numbers instead of generalities? |
+
+| Edge cases and nuance | 5 | Does the content address exceptions, caveats, and "it depends" scenarios? |
+
+| Follow-up anticipation | 5 | Does the content proactively answer likely follow-up questions? |
+
+### Scoring Guide (4)
+
+- 0-5: Surface-level, could be written without expertise
+- 6-10: Covers basics but lacks depth
+
+- 11-15: Solid coverage with good specifics
+- 16-20: Comprehensive, expert-level depth with nuance
+
+## 5. Technical Optimization (20 points)
+
+| Criterion | Points | What to Look For |
+
+|-----------|--------|------------------|
+
+| Schema markup | 5 | Appropriate JSON-LD present (Article, FAQ, HowTo, Product, etc.)? |
+
+| Meta description | 5 | Meta description is a clear, concise answer to the primary query? Under 160 chars? |
+
+| Semantic HTML | 5 | Proper use of article, section, header, nav, main tags? Clean heading hierarchy in HTML? |
+
+| Page performance | 5 | Fast load time? No excessive scripts blocking content? Mobile-friendly? |
+
+### Scoring Guide (5)
+
+- 0-5: No technical optimization
+- 6-10: Basic meta tags but no schema or poor HTML
+
+- 11-15: Good technical foundation with minor gaps
+- 16-20: Full schema markup, optimized meta, clean HTML, fast loading

package/.local/secondary_skills/geo/references/technical-checklist.md

@@ -0,0 +1,257 @@
+# GEO Technical Optimization Checklist
+
+Technical optimizations that help AI engines discover, parse, and cite your content.
+
+## Schema Markup (JSON-LD)
+
+Schema markup helps AI engines understand content type and structure. Use JSON-LD format in the `<head>` or end of `<body>`.
+
+### By Content Type
+
+**Article / Blog Post:**
+
+```json
+
+{
+
+"@context": "https://schema.org",
+
+"@type": "Article",
+
+"headline": "How to Choose the Right CRM for Your Business",
+
+"author": {
+
+"@type": "Person",
+
+"name": "Jane Smith",
+
+"jobTitle": "CRM Consultant",
+
+"url": "https://example.com/about/jane-smith"
+
+},
+
+"datePublished": "2025-01-15",
+
+"dateModified": "2025-03-20",
+
+"publisher": {
+
+"@type": "Organization",
+
+"name": "Example Inc."
+
+},
+
+"description": "A comprehensive guide to selecting the right CRM system based on team size, budget, and use case."
+
+}
+
+```
+
+**FAQ Page:**
+
+```json
+
+{
+
+"@context": "https://schema.org",
+
+"@type": "FAQPage",
+
+"mainEntity": [
+
+{
+
+"@type": "Question",
+
+"name": "How much does a CRM cost?",
+
+"acceptedAnswer": {
+
+"@type": "Answer",
+
+"text": "CRM pricing ranges from free for basic tools to $300+/user/month for enterprise solutions. Most small businesses spend $12-$50/user/month."
+
+}
+
+}
+
+]
+
+}
+
+```
+
+**HowTo (step-by-step guides):**
+
+```json
+
+{
+
+"@context": "https://schema.org",
+
+"@type": "HowTo",
+
+"name": "How to Set Up a CRM in 5 Steps",
+
+"step": [
+
+{
+
+"@type": "HowToStep",
+
+"name": "Define your requirements",
+
+"text": "List the features your team needs: contact management, pipeline tracking, email integration, reporting."
+
+}
+
+]
+
+}
+
+```
+
+**Product Page:**
+
+```json
+
+{
+
+"@context": "https://schema.org",
+
+"@type": "Product",
+
+"name": "ProductName Pro",
+
+"description": "...",
+
+"offers": {
+
+"@type": "Offer",
+
+"price": "29.99",
+
+"priceCurrency": "USD"
+
+},
+
+"aggregateRating": {
+
+"@type": "AggregateRating",
+
+"ratingValue": "4.7",
+
+"reviewCount": "1250"
+
+}
+
+}
+
+```
+
+**Organization (site-wide, placed on homepage):**
+
+```json
+
+{
+
+"@context": "https://schema.org",
+
+"@type": "Organization",
+
+"name": "Example Inc.",
+
+"url": "https://example.com",
+
+"foundingDate": "2018",
+
+"description": "...",
+
+"sameAs": [
+
+"https://twitter.com/example",
+
+"https://linkedin.com/company/example"
+
+]
+
+}
+
+```
+
+## Meta Description Optimization
+
+AI engines sometimes use meta descriptions as quick summaries. Optimize them for extraction:
+
+- Write the meta description as a direct answer to the primary query the page targets
+- Keep under 155-160 characters
+
+- Include one key data point or specific claim
+- Avoid generic marketing language
+
+**Good:** `"Kitchen renovations cost $15,000-$45,000 on average in 2025. Scope, materials, and location are the biggest cost factors."`
+
+**Bad:** `"Learn everything you need to know about kitchen renovations. Click to read more!"`
+
+## Semantic HTML
+
+Clean HTML structure helps crawlers parse content accurately:
+
+- Use `<article>` for the main content body
+- Use `<section>` to group thematic content blocks
+
+- Use `<header>`, `<nav>`, `<main>`, `<footer>` for page regions
+- Use `<figure>` and `<figcaption>` for images with descriptions
+
+- Use `<table>` for tabular data (not divs styled as tables)
+- Use `<blockquote>` and `<cite>` for quoted material
+
+- Maintain proper heading hierarchy (H1 > H2 > H3, no skipped levels)
+- Use `<time datetime="2025-01-15">` for dates
+
+## Page Performance
+
+AI engine crawlers have timeouts. Slow pages may not get fully indexed:
+
+- Target < 3 second load time
+- Minimize render-blocking JavaScript
+
+- Ensure content is in the initial HTML (not loaded via client-side JS after page load) — server-side rendering or static generation is strongly preferred
+- Use lazy loading for below-fold images, but ensure above-fold content loads immediately
+
+- Compress images appropriately
+
+## Crawlability
+
+- Ensure pages are accessible to crawlers (not blocked by robots.txt)
+- Submit XML sitemaps to search engines
+
+- Use canonical URLs to avoid duplicate content issues
+- Internal linking between related content helps crawlers discover depth
+
+- Avoid JavaScript-only navigation that crawlers can't follow
+
+## Content Accessibility Signals
+
+- Alt text on all images (descriptive, not keyword-stuffed)
+- Proper link text (descriptive, not "click here")
+
+- Language attribute on HTML tag
+- Character encoding declaration (UTF-8)
+
+## robots.txt Considerations
+
+Major AI crawlers use specific user agents. Be aware of these if you want to control AI engine access:
+
+- `GPTBot` — OpenAI's crawler
+- `Google-Extended` — Google's AI training crawler (separate from Googlebot)
+
+- `CCBot` — Common Crawl (used by many AI training datasets)
+- `PerplexityBot` — Perplexity's crawler
+
+- `ClaudeBot` — Anthropic's crawler
+
+To be cited by AI engines, ensure these crawlers are NOT blocked. If they are blocked in robots.txt, your content cannot be indexed or cited.

package/.local/secondary_skills/github-solution-finder/.fingerprint

@@ -0,0 +1 @@
+cb6cb04e2f77c726d53102abc4afc6e7