competitive-feature-matrix-builder

Competitive Feature Matrix Builder

This skill reads a folder of competitor notes (md or txt files) and produces a comparative feature matrix with a gap analysis and recommendations. No web access or API required — fully file-based, designed for Cowork.

Input:

• Folder path containing competitor notes (one file per competitor recommended; md or txt format)
• Optional: a file named your-product.md or own-product.md for self-comparison

Output:

• Markdown response with three sections: Feature Matrix (table), Gap Analysis, and Recommendations

---

Language Detection

Detect the user's language from their message:

• If Russian (or contains Cyrillic): respond in Russian
• If English (or other Latin-script language): respond in English
• If ambiguous: respond in the language of the trigger phrase used

---

Instructions

Step 1: Validate Input

1. Check that the user provided a folder path.

   • If no path given: stop and respond: "Provide the path to a folder containing competitor notes in md or txt format."

2. Scan the folder for md and txt files.

   • If folder is empty or does not exist: stop and respond: "No files found at the provided path. Provide a folder path containing competitor notes in md or txt format."
   • Report the number of files found: "Found N files: [list filenames]."

3. Check if any file is named your-product.md or own-product.md.

   • If found: include as "Your Product" column in the matrix.
   • If not found: proceed without self-comparison column; add a closing note: "Add a file named your-product.md to enable self-comparison and gap analysis."

Step 2: Extract Competitor Names and Features

1. For each file (excluding your-product.md/own-product.md if present):
   • Competitor name: Use the first-level heading (# Name) if present; otherwise use the filename without extension (e.g., salesforce-notes.md → "Salesforce").
   • Feature extraction: Scan the file for product features, capabilities, and attributes using these signals:
     • Explicit feature lists (bullet points, numbered lists, tables)
     • Sentences with action verbs: "supports", "offers", "includes", "has", "provides", "enables"
     • Comparison language: "unlike X, they have…", "also includes…", "unique to them…"
     • Section headings describing product areas (e.g., "Integrations", "Analytics", "Pricing")