mirror of
https://github.com/NickCrew/Claude-Cortex.git
synced 2026-09-14 20:17:11 +08:00
Nicholas Ferguson
228e6de997
Move the 686-line skill-authoring-cookbook from docs/tutorials/ (which is unpublished) to site/tutorials/skill-authoring.md (the canonical user-facing doc home). The cookbook covers directory structure, SKILL.md frontmatter, progressive disclosure, quality rubrics, and common authoring patterns — all user-facing content that belonged on the published site. - site/tutorials/skill-authoring.md: published from the former cookbook with adjusted frontmatter (title, nav_order 1.5 to sit next to skill-recommendations, new permalink). - site/tutorials/index.md: new landing-page entry linking to the tutorial with a 30-45 minute estimate. - docs/tutorials/skill-authoring-cookbook.md: removed (canonical copy now in site/). - docs/NAVIGATOR.md, docs/README.md, docs/tutorials/index.md, docs/tutorials/learning-paths/onboarding.md, docs/tutorials/ci-cd-integration.md: inbound references to the cookbook replaced with prose pointers to the site/ location. Resolves the dangling link in site/guides/working-with-skills.md that referenced the tutorial before it existed on the published site.
2.5 KiB
2.5 KiB
Cortex Documentation
This docs/ tree is the currently published documentation source for GitHub
Pages in this repository.
Recommendation System Entry Points
If you are looking for the recommendation stack specifically, start here:
- AI Intelligence Features
- user-facing overview of the agent recommendation system
- covers
cortex ai recommend, watch mode, TUI integration, and session learning
- Skill Recommendation Engine
- architecture overview of the skill recommendation pipeline
- explains the prompt hook,
SkillRecommender, rule files, and storage
- Skill Recommendation & Review Learning
- developer guide for skill-learning internals and review ingestion
- AI Intelligence System: Technical Architecture
- developer guide for agent-learning internals and workflow prediction
- Skills Guide
- user-facing skill usage, recommendation, and rating commands
- AI Watch Mode Tutorial
- live walkthrough for watch mode and the AI Assistant
- Documentation Navigator
- broader map by audience and topic
Broader Documentation Map
Architecture
User Guides
User-facing skill authoring tutorial now lives in the published site at
site/tutorials/skill-authoring.md.
Development Guides
Notes
- The recommendation system has two distinct halves: agent intelligence and skill recommendations. Avoid using those terms interchangeably in docs.
- When the command surface changes, update both the user-facing pages and the developer-facing architecture pages in the same slice to avoid drift.
- Contributor-oriented skill onboarding lives in the Skills Guide and the Skill Authoring Cookbook; use those instead of reconstructing the workflow from historical architecture notes.