vt-su-hc-inbox-qualify¶
Evaluate and categorize incoming Help Center content proposals from content/00-inbox/. Assesses merit, suggests target category (FAQ, User Manual, Getting Started, Announcements), and moves qualified items to content/01-proposals/ or rejects with reason.
Plugin: support
Category: Other
Command: /vt-su-hc-inbox-qualify
Help Center Inbox Qualify¶
Evaluate raw content items dropped into the Help Center inbox and route them to the proposal stage or reject them.
Commands¶
scan (default)¶
Scan content/00-inbox/ for unprocessed items and report status.
Process:
1. List all .md files in content/00-inbox/ (exclude README.md)
2. For each file, check if it has a status: field in YAML frontmatter
3. Report:
- New items (no status or status: new)
- Already qualified (status: qualified)
- Already rejected (status: rejected)
4. Display summary table
qualify <file> or qualify --all¶
Evaluate one or all inbox items.
Process:
1. Read the file from content/00-inbox/
2. Analyze the content to determine:
- Category: FAQ, User Manual, Getting Started, Announcements, Release Notes, or Reject
- Language detection: What language is the source content in?
- Article count estimate: How many individual articles can be extracted?
- Quality assessment: Is the content clear enough to draft articles from?
- Missing information: What additional context is needed?
3. Present assessment to user via AskUserQuestion:
- Accept as [Category] — move to proposals with metadata
- Accept with different category — user overrides suggested category
- Reject — mark as rejected with reason, keep in inbox
- Needs more info — add questions, keep in inbox
4. If accepted:
- Add YAML frontmatter with qualification metadata:
---
status: qualified
qualified_at: "YYYY-MM-DD"
source_file: "original-filename.md"
target_category: faq
target_sections: ["registrierung", "wallet"]
source_language: de
estimated_articles: 5
notes: "Clear content, ready for proposal"
---
content/01-proposals/ with updated frontmatter
- Remove original from content/00-inbox/ (or mark as processed)
5. If rejected:
- Add status: rejected, rejected_at, rejection_reason to frontmatter
- Keep in content/00-inbox/ (not moved)
Qualification Criteria¶
| Criterion | Accept | Reject |
|---|---|---|
| Content clarity | Clear topic, actionable information | Vague, no clear topic |
| Relevance | Related to VisiMatch/VisiFair platform | Unrelated to products |
| Completeness | Enough detail to draft an article | Just a title or one sentence |
| Duplication | New information not already in Help Center | Exact duplicate of existing article |
| Language | Phase 1: DE, EN, NL, RO. Phase 2 (future): fr-BE, nl-BE, FR | Unsupported language |
Integration¶
- Input: Raw content dropped into
content/00-inbox/by anyone - Output: Qualified proposals in
content/01-proposals/ - Next skill:
/vt-su-hc-content-proposeenriches qualified items - Sync: Does NOT trigger sync — only organizes content
Content Sources (Expected)¶
- Support ticket patterns (common questions → FAQ candidates)
- Feature documentation updates
- Partner feedback and onboarding gaps
- Release notes from Azure DevOps (SPEC-008)
- Internal team knowledge drops
- Manual notes and observations