research-guide-updater

Incrementally updates project writing guides with reusable insights from conversations.

2.7k|251|Updated Feb 12, 2024
One-click install
npx skills add https://github.com/huangwb8/ChineseResearchLaTeX --skill research-guide-updater
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: research-guide-updater
Source: https://github.com/huangwb8/ChineseResearchLaTeX/tree/main/skills/research-guide-updater
Command: npx skills add https://github.com/huangwb8/ChineseResearchLaTeX --skill research-guide-updater

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Writing insights discovered during AI-assisted research conversations are easily lost, causing terminology drift and inconsistent style across grant proposals and papers. This Skill captures those insights and merges them into an existing project guide file without restructuring it.

Core Features & Use Cases

  • Atomic insight extraction: Splits user input into single-claim statements and maps each to the correct guide section (writing philosophy, terminology, methodology, risks, appendix).
  • Minimal-patch updates: Adds only 1-3 bullets into existing sections without creating new level-2 headings or reordering content.
  • Structure validation: Runs scripts/validate_guide.py to confirm the seven required headings remain intact after every update.
  • Use Case: After a literature review session, ask the AI to distill the findings into your 项目指南.md so terminology and review-response wording stay consistent across the whole proposal.

Quick Start

Update the project guide at projects/MyProject/项目指南.md with the new rule that all abbreviations must use the full-name-plus-abbreviation format on first occurrence.

Frequently Asked Questions about research-guide-updater

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update a project writing guide with new insights?

Specify the guide file path in your prompt, such as "update the project guide at projects/MyProject/项目指南.md", then state the insight. The skill extracts atomic points and inserts them as minimal bullet patches into matching sections.

How do I validate a Markdown guide structure with a script?

Run python3 skills/research-guide-updater/scripts/validate_guide.py followed by the guide file path. It checks for seven required level-2 headings and prints [OK] when the structure is intact or lists missing headings.

Does the guide updater change existing headings or structure?

No. It never adds new level-2 headings, never renames or reorders existing ones, and only appends one to three bullets inside existing sections. The validation script fails if required headings are missing.

Can I use literature review output to update my writing guide?

Yes. The recommended workflow runs a literature review skill first, then reads those review files as read-only input and incrementally merges the distilled insights into the project guide without modifying the source reviews.

What happens when an insight cannot be verified?

Unverifiable facts or references are marked as 待核验 (pending verification) instead of being written as fact. The skill never fabricates citations, author names, or specific numbers.