doc-creation

To create markdown files in managed documentation directories, use the `/docs new` command. This ensures the file is correctly added to the documentation index with proper frontmatter registration.

Creating a new README.md directly in a docs folder is intercepted to prevent untracked documents from accumulating. The system checks if the target path is within a docs-manager library before allowing normal file creation.

The best way to prevent untracked markdown documents in a docs-manager library is to use the `/docs new` command for proper frontmatter and index registration instead of manual file creation.

Yes, this skill allows normal file creation outside of known docs directories. It specifically intercepts new `.md` file creation attempts within managed documentation locations to provide proactive guidance.

When you try to create a new `.md` file in a project's `/docs/` folder, the skill prompts you to use `/docs new` instead, ensuring the new document is correctly added to the documentation's index.