Skip to content

✨ Update skill to use cnspec CLI for schema discovery - #8

Merged
chris-rock merged 1 commit into
mainfrom
feat/cnspec-cli-schema-tools
Apr 20, 2026
Merged

✨ Update skill to use cnspec CLI for schema discovery#8
chris-rock merged 1 commit into
mainfrom
feat/cnspec-cli-schema-tools

Conversation

@chris-rock

Copy link
Copy Markdown
Member

Summary

  • Update SKILL.md to recommend cnspec CLI as the primary interface for schema discovery, with MCP as an alternative
  • Document all 4 new cnspec providers commands with --json output examples
  • Add MCP-to-CLI mapping table so agents can use either interface
  • Add ADR-001 documenting the decision, implementation, and output format differences

Depends on: mondoohq/mql#7197

Test plan

  • Verify SKILL.md renders correctly in GitHub
  • Verify CLI commands in SKILL.md match actual cnspec output after mql#7197 is merged
  • Verify ADR reflects the implemented command structure

🤖 Generated with Claude Code

@mondoo-code-review mondoo-code-review Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Skill documentation updated to recommend cnspec CLI over MCP server for schema discovery, with a well-structured ADR explaining the decision.

Comment thread skills/mondoo-mql/SKILL.md
Comment thread skills/mondoo-mql/SKILL.md

@mondoo-code-review mondoo-code-review Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Internal ADR document removed from skills repo; previous unresolved findings in SKILL.md remain unaddressed.

Additional findings (file/line not in diff):

  • 🔵 docs/adr-001-cnspec-cli-agent-ergonomics.md:1 — Removing the internal ADR is fine, but the two previous findings on skills/mondoo-mql/SKILL.md (the local connector limitation for cloud-provider queries at line 96, and the cnspec policy init vs MCP tool mismatch at line 131) are still unaddressed by this commit. Consider tackling those in a follow-up.

Update SKILL.md to recommend cnspec CLI as the primary interface for
schema discovery and query validation, with MCP as an alternative.

- Document all 4 new provider CLI commands with JSON examples
- Add MCP-to-CLI mapping table for easy reference
- Update workflow to reference cnspec commands

Depends on: mondoohq/mql#7197

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@chris-rock
chris-rock force-pushed the feat/cnspec-cli-schema-tools branch from a69e7fc to eda14c7 Compare April 15, 2026 19:55
@chris-rock
chris-rock merged commit b98499f into main Apr 20, 2026
2 checks passed
@chris-rock
chris-rock deleted the feat/cnspec-cli-schema-tools branch April 20, 2026 11:38
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.

1 participant