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.
Remove references to non-existent modes/, workflows/, profiles/, scenarios/,
and flags/ directories across 11 documentation files. These described a
planned "three-layer system" that was superseded by the current skills-based
architecture.
Key changes:
- AGENTS.md: update core module tree to match actual codebase
- docs/index.md: fix version (2.0.0 → 3.0.1), remove Mode/Workflow/Flag sections
- docs/guides/hooks.md: replace 7 phantom hooks with 9 actual hooks
- docs/reference/api/index.md: list actual core modules
- docs/reference/architecture/: remove three-layer references, fix paths
- Archive quick-reference.md (entirely phantom content)
- Fix broken modes.html links and stale CLI command references
Priority 1 & 3 code review improvements:
- Add source path existence validation before all symlink operations
- Add (OSError, PermissionError) try/except blocks to symlink creation/removal
- Separate error handling for unlink and symlink_to operations
- Fix uninitialized source_path in _agent_activate_recursive (init to None)
- Add specific error messages for each failure mode
Files changed:
- agents.py: Updated _agent_activate_recursive and agent_deactivate with
proper error handling and source_path initialization fix
- skills.py: Enhanced skill_activate/skill_deactivate with source validation
and specific exception handling
- rules.py: Updated rules_activate/rules_deactivate to catch PermissionError
and provide clear error messages
- asset_installer.py: Apply same patterns to all install functions
This ensures robust symlink operations with clear feedback on failure modes.
Remove cortex-workflow references since the command is not implemented
and workflow orchestration is currently handled through composition of
existing commands (agent, skills, review, plan, export, ai).
- Remove workflow subcommand from validation and generation
- Remove cortex-workflow.1 from manpage bundle
- Delete placeholder cortex-workflow.1 manpage file
This keeps the build clean and only bundles manpages for implemented
commands (cortex.1 and cortex-tui.1).
- Add comprehensive TUI getting started tutorial (1045 lines)
- 11-part progressive tutorial covering installation through advanced features
- Clear CLI-only feature markers for power users
- 60+ code examples with checkpoints and troubleshooting
- Added to site navigation and main page
- Transform Phase 4/5 planning docs into user-focused feature documentation
- Created skill-composition-versioning.md (concise dependency & version guide)
- Created skill-ratings-analytics.md (ratings, analytics, AI recommendations)
- Removed implementation timelines and planning details
- Focus on usage, benefits, and best practices
- Update site navigation
- Add tutorials to header navigation via _config.yml
- Fix Jekyll URL structure (directory-based permalinks)
- Create tutorials landing page with learning paths
- Archive planning documents
- Move PHASE5_ROADMAP.md to archive/reports/
- Rename phase4-summary.md to PHASE4_SUMMARY.md for consistency
- Preserve historical planning docs for reference
Nicholas Ferguson