skills.rest
NAMEWTA
NAMEWTACOMMUNITY
Explore all skills by this author →
GitHub

knowledge-promotion

Plans and applies Markdown knowledge promotion with review-state tracking and index updates.

2|Updated Jul 6, 2026
Search Tags:#markdown#indexing#rollback#knowledge management#spaced repetition#learning workflow#review tracking
One-click install
npx skills add https://github.com/NAMEWTA/learning-open-code --skill knowledge-promotion-namewta
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: knowledge-promotion
Source: https://github.com/NAMEWTA/learning-open-code/tree/main/speculo/workflows/learning/common/skills/knowledge-promotion
Command: npx skills add https://github.com/NAMEWTA/learning-open-code --skill knowledge-promotion-namewta

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It turns completed learning changes into durable, organized Markdown knowledge while preventing uncontrolled writes, duplicate entries, and broken index links in a Learning knowledge base. ## Core Features & Use Cases - Plan Promotion: Analyzes completed changes against existing indexes to produce create, merge, supersede, or archive-only plans staged in promotion-staging/ without writing to the knowledge base. - Apply Promotion: Executes only confirmed plans after drift re-validation, with full rollback snapshots in promotion-rollback/ and reverse-order recovery on validation failure. - Review State Tracking: Marks knowledge as mastered, review_due, or needs_refresh with last-verified and next-review dates for spaced repetition. - Use Case: After finishing a learning session on a new topic, invoke this Skill to merge the validated findings into the domain knowledge file, update the domain INDEX and master INDEX, and schedule the next review date. ## Quick Start Ask the agent to plan a knowledge promotion for the completed change in the Learning context and confirm the exact target paths before applying it.

Frequently Asked Questions about knowledge-promotion

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

FAQPage Schema
How do I promote completed learning notes into a permanent knowledge base?▼

Run plan-promotion mode to analyze the completed change against existing indexes and produce a create, merge, supersede, or archive-only plan staged in promotion-staging. After confirming exact paths, apply-promotion executes the plan with drift checks and rollback snapshots.

How does the skill decide between creating, merging, or superseding knowledge?▼

It matches candidates by exact Knowledge ID against the master index and domain INDEX, never by full-text similarity. No matching ID means create, compatible conclusions mean merge, and new evidence overturning current conclusions means supersede.

Can the skill write to the knowledge base without confirmation?▼

No. Plan mode performs no writes, and apply mode requires the caller to obtain user confirmation of exact paths and actions. Staged content in promotion-staging is not considered a context write until explicitly confirmed.

What happens if applying a knowledge promotion fails partway through?▼

The skill re-validates all touched files and links, then restores originals in reverse order using snapshots saved in promotion-rollback. Files that did not previously exist are deleted, and validation runs again before any further archiving continues.

How does spaced repetition review tracking work for knowledge entries?▼

The mark-review-state mode updates only the specified knowledge file and its REVIEW row, setting status to mastered, review_due, or needs_refresh along with last-verified evidence and the next review date. It never rewrites unrelated knowledge or archives.

Related Skills

Explore More Education & Research Skills→
aurora-atomsaurora-atoms

learning-navigator

Structure technical domains into layered, evidence-linked learning paths.

Community
Advanced
akiotanaka847akiotanaka847
2

track-compliance-deadlines

Scan HR policy inputs and generate dated compliance reminders in a calendar file.

Community
Advanced
cpfcoachingcpfcoaching

Gardening Skills Wiki

Validate links, naming consistency, and INDEX coverage in a gardening skills wiki.

Community
Advanced
shalevaminshalevamin

rag-architect

Designs and implements RAG systems with chunking, embedding generation, vector stores, hybrid search, reranking, and evaluation.

Community
Advanced