Skip to content

Add new-page skill - #12192

Open
dbreseman wants to merge 20 commits into
developmentfrom
docs-drafting-skill
Open

dbreseman wants to merge 20 commits into
developmentfrom
docs-drafting-skill

Conversation

@dbreseman

Copy link
Copy Markdown
Collaborator

No description provided.

Comment thread .claude/skills/docs-new-page/SKILL.md Outdated
* In the front matter, complete `title`, `url`, and `description`, plus any other fields the page needs. Uncomment those fields, and delete the commented fields you don't use.
* Replace or remove every `{…}` placeholder and instruction comment.
* Delete optional sections that don't apply.
7. Complete the introduction and the remaining sections. Content varies by content type. Add images only if the user provides them. Where an image is needed and none is available, leave out the `figure` shortcode and list the location in your final summary.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

After this step, review files created vs input provided and give the user a summary of what was done. Flag if any input was omitted and why.

@dbreseman dbreseman Nov 17, 2026 •

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also search sibling files and flag to the user if anything might need updating in other files (labels, dates, etc) and if there are any conflicts. Prioritize technical accuracy, and if it isn't clear which version to trust, ask.

Comment thread .claude/skills/docs-new-page/SKILL.md Outdated
If the user provides a link, read it only if you have a tool that can access it. If you can't access it, say so and ask the user to paste the content.
2. Explore `content/en/docs/` and decide where the page belongs (if it isn't clear, ask the user to confirm). Read the section's `_index.md` and nearby pages to match their conventions.
3. Search `content/en/docs/` for the page's main terms. Ignore the versioned folders for older Mendix versions (`refguide10`, `howto9`, and so on) unless the user says the page is for an older version. If a page already covers the entire topic, tell the user and ask whether to update that page instead. If a page covers part of it, link to that page instead of repeating the covered content, and ask the user whether the missing content belongs on the existing page or on the new one. Note any pages that need a link to the new page, and tell the user at the end.
4. Read the appropriate template from `templates/`.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

After this step, present a plan to the user for confirmation or adjustments. If there is missing or ambiguous information, ask for it.

@dbreseman dbreseman Nov 17, 2026 •

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If no template fits, say so (and ask if you should generate based on the sibling style)

Comment thread .claude/skills/docs-new-page/SKILL.md Outdated
2. Explore `content/en/docs/` and decide where the page belongs (if it isn't clear, ask the user to confirm). Read the section's `_index.md` and nearby pages to match their conventions.
3. Search `content/en/docs/` for the page's main terms. Ignore the versioned folders for older Mendix versions (`refguide10`, `howto9`, and so on) unless the user says the page is for an older version. If a page already covers the entire topic, tell the user and ask whether to update that page instead. If a page covers part of it, link to that page instead of repeating the covered content, and ask the user whether the missing content belongs on the existing page or on the new one. Note any pages that need a link to the new page, and tell the user at the end.
4. Read the appropriate template from `templates/`.
5. Create the new file based on the template. File names must be simple, lowercase, and hyphen-separated.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Adjust—not necessarily one new file (it's possible that several files are needed). Also check if a release note is needed.

Comment thread .claude/skills/docs-new-page/SKILL.md Outdated
7. Complete the introduction and the remaining sections. Content varies by content type. Add images only if the user provides them. Where an image is needed and none is available, leave out the `figure` shortcode and list the location in your final summary.
8. Verify that any linked pages exist in the repo, using each target page's `url` front matter field. Link to the related pages found in step 3.
9. Run the `docs-copyedit` and `docs-alt-text` skills on the new page.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Run docs-pr-review afterwards

Comment thread .claude/skills/docs-new-page/SKILL.md Outdated
8. Verify that any linked pages exist in the repo, using each target page's `url` front matter field. Link to the related pages found in step 3.
9. Run the `docs-copyedit` and `docs-alt-text` skills on the new page.

Don't add product claims, technical behavior, or release facts that the user didn't provide. If more information is needed, ask the user to provide it.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note to keep in mind during review: pay special attention to figures, tables, code blocks, etc. Are they used appropriately? Is it correctly interpreting where they belong?

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants