skills.rest
novadb
novadbOFFICIAL
Explore all skills by this author →
GitHub

create-comment

Create XHTML-wrapped comments on NovaDB objects and fetch full records.

Updated Feb 27, 2026
Search Tags:#audit#branch#create#cms#comment#xhtml#novadb
One-click install
npx skills add https://github.com/novadb/claude-plugins --skill create-comment
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-comment
Source: https://github.com/novadb/claude-plugins/tree/main/consulting/skills/create-comment
Command: npx skills add https://github.com/novadb/claude-plugins --skill create-comment

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many NovaDB workflows require adding review or audit notes to objects, but the create-comment API only returns an identifier and requires a follow-up fetch to obtain the full comment. This Skill handles the end-to-end creation and retrieval so users get the complete comment data without manually orchestrating the steps.

Core Features & Use Cases

  • Two-step workflow: Calls the create-comment API to receive an id and immediately fetches the full comment using that id.
  • XHTML body enforcement: Ensures the comment body is valid XHTML with a div root, wrapping plain text when necessary.
  • Parameters & audit: Accepts branchId, objectRef, body (XHTML), and optional username for auditing and multi-branch workflows.
  • Use Case: Add a reviewer comment to an object in a development branch and return the full comment record including author and timestamps.

Quick Start

Create a new comment on a specific NovaDB object by providing the branchId, objectRef, and a div-wrapped XHTML body.

Frequently Asked Questions about create-comment

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

FAQPage Schema
How do I add an audit comment to a NovaDB object in a specific branch?▼

Adding comments to NovaDB objects requires a branchId, objectRef, and an XHTML-wrapped body. The Skill validates the div root, calls the create API for an id, then performs a get call to return the complete comment record with timestamps.

Does the NovaDB create comment API return the full comment record?▼

The NovaDB create comment API only returns a comment identifier. This Skill handles the end-to-end workflow by immediately performing a follow-up fetch using the new id to retrieve the full comment record including author and timestamps.

What format does the comment body need to be in for NovaDB workflows?▼

The comment body must be valid XHTML with a div root. The Skill enforces this by automatically wrapping plain text in a div element when necessary before submitting it to the NovaDB create comment API.

What parameters are required to create a reviewer note on a NovaDB object?▼

Creating a reviewer note requires branchId, objectRef, and a div-wrapped XHTML body. An optional username parameter can also be included to support auditing and multi-branch review workflows within NovaDB.

Why does my plain text comment fail when submitted to the NovaDB API?▼

Plain text comments fail because the NovaDB API requires valid XHTML. This Skill resolves the issue by automatically validating and wrapping plain text bodies with a div root before calling the create comment API.

Related Skills

Explore More Software Engineering Skills→
novadbnovadb

get-comments

Lists filtered, paginated NovaDB comments with continuation tokens.

Official
Basic
novadbnovadb

get-comment

Fetches a single comment by its ID from NovaDB CMS.

Official
Basic
novadbnovadb

generate-code-for-types

Generate C# source code for multiple or all object types in a NovaDB branch.

Official
Intermediate
walekingwaleking

notion-workspace

Automate Notion workspace search, retrieval, creation, and organization via MCP API endpoints.

Community
Basic