Developers

NCReport skill for AI coding agents

A set of Markdown files that teach Claude Code, Codex, Cursor and other coding agents how to integrate NCReport correctly, instead of guessing from old forum posts.

What the agent learns

The NCReport class and its run methods, data sources from SQL and Qt models, the .ncr template XML and its expression syntax, linking with qmake or CMake, and deployment.

Checked against the source

An API index generated from the NCReport 2.36 headers lists every exported class and method with its exact signature, so the agent can check a name before using it. Template names come from the template reader, and the examples were compiled and run.

Small by design

SKILL.md holds the rules and a map; the agent loads a reference file only when the task needs it, and follows links to the Definitive Guide for the details.

Install the skill

Claude Code loads skills from ~/.claude/skills/ (all your projects) or .claude/skills/ in a project. Other agents that support Agent Skills use a similar folder; check their documentation. Run the command again to update.

mkdir -p ~/.claude/skills/ncreport && (cd ~/.claude/skills/ncreport && \
for f in SKILL.md references/api-index.md references/api.md references/build-and-deploy.md references/templates.md references/tools.md references/troubleshooting.md; do
  mkdir -p "$(dirname "$f")" && curl -fsSL -o "$f" "https://ncreport.org/skills/ncreport/$f"
done)

Any other agent

Agents without skill support can read the files by URL. Add a line like this to your AGENTS.md, CLAUDE.md, .cursorrules or Copilot instructions:

AGENTS.md
Before writing or changing NCReport code, report templates (.ncr) or build files,
read https://ncreport.org/skills/ncreport/SKILL.md and the reference files it points to.
This copy covers NCReport 2.36. From version 2.36 on, every NCReport package also contains the skill for its own version, in skills/ncreport/. With an older version, tell the agent which one you use: it will check method names against your headers.
Contents

Files in the skill

Served from https://ncreport.org/skills/ncreport/. Agents read them as plain Markdown.

Try NCReport free

Fully working evaluation packages for Windows, Linux, macOS, iOS and Raspberry Pi. The only limit is an evaluation label on printed pages.