Skip to content

Merge Fin AI best practices into lfx-intercom skill#46

Open
clkrueger wants to merge 5 commits intolinuxfoundation:mainfrom
clkrueger:merge-fin-best-practices-into-lfx-intercom
Open

Merge Fin AI best practices into lfx-intercom skill#46
clkrueger wants to merge 5 commits intolinuxfoundation:mainfrom
clkrueger:merge-fin-best-practices-into-lfx-intercom

Conversation

@clkrueger
Copy link
Copy Markdown

Closes #43

Summary

Merges Fin AI best practices content into the existing lfx-intercom skill rather than maintaining a separate skill, as agreed with @niravpatel27 and @mlehotsky. This makes lfx-intercom the single entry point for all Intercom questions at LFX, with context-based routing to the right section.

What's changed

lfx-intercom/SKILL.md

  • Updated description frontmatter to cover both audiences (Angular developers and support/CX teams)
  • Added Step 0 — Detect Context routing step: reads the user's request and routes to code integration steps or Fin/CX best practices without asking unless genuinely ambiguous

lfx-intercom/references/fin-best-practices.md (new)

  • The 7 pillars of Fin excellence (guidance writing, content strategy, escalation, tagging, etc.)
  • Continuous improvement patterns (Topics Explorer, daily review ritual, AI Suggestions)
  • Copilot use cases for human agents
  • Data quality and conversation tagging patterns
  • Real-world benchmarks from production Fin deployments (55% → 80%+ resolution rates)
  • Source: Intercom Community expert users and Intercom team members

Acceptance criteria

  • Single lfx-intercom skill handles both developer and support/CX Intercom questions
  • Routing detects context from user input — only prompts when intent is ambiguous
  • Fin best practices content fully intact in references/fin-best-practices.md
  • License headers present on all files

Supersedes PR #44.

This document provides best practices for optimizing Fin AI Agent performance, including guidance on writing, content optimization, daily reviews, and AI suggestions.

Signed-off-by: Connie Krueger <ckrueger9700@gmail.com>
Updated the LFX Intercom skill documentation to enhance clarity and detail regarding integration steps, context detection, and environment configuration.

Signed-off-by: Connie Krueger <ckrueger9700@gmail.com>
Copilot AI review requested due to automatic review settings April 9, 2026 18:52
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR consolidates Intercom guidance into a single lfx-intercom skill by adding Fin AI optimization best practices and introducing a context-detection “Step 0” to route users to either developer integration guidance or support/CX optimization guidance.

Changes:

  • Expanded lfx-intercom skill frontmatter and added “Step 0 — Detect Context” routing guidance.
  • Added a new Fin AI best-practices reference document under lfx-intercom/references/.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
lfx-intercom/SKILL.md Updates skill description and adds context routing, but currently removes the detailed Angular integration workflow content.
lfx-intercom/references/fin-best-practices.md Adds a Support/CX-facing reference with Fin optimization pillars, improvement loops, tagging, escalation, and benchmarks.
Comments suppressed due to low confidence (1)

lfx-intercom/SKILL.md:41

  • The PR description says Fin best practices are being merged into the existing lfx-intercom skill, but this change also removes the entire previous Angular Intercom integration workflow (Steps 1–7) and leaves the “## Code Integration” section with only a two-line introduction. As-is, the skill no longer provides the canonical integration/audit steps it previously encoded and does not meet the acceptance criterion of handling developer integration questions. Please restore the original integration steps under “## Code Integration”, or move them into a separate reference file and link to it here.
## Code Integration

You are bringing Intercom up to the LFX standard in an Angular application. This
skill handles both fresh installs and fixing/standardizing existing integrations.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

mlehotskylf and others added 3 commits April 9, 2026 13:06
…itions

Updated the SKILL.md file to enhance the Intercom integration process, including detailed steps for setup, auditing, and verification.

Signed-off-by: Connie Krueger <ckrueger9700@gmail.com>
Updated formatting in SKILL.md to correct typographic errors and ensure consistency in bullet points and headings.

Signed-off-by: Connie Krueger <ckrueger9700@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add lfx-intercom-fin-best-practices skill

3 participants