Fork me on GitHub

Using with Claude Code

Claude Code is an AI-powered coding assistant that can help you work with Metaschema and OSCAL tools more effectively.

Claude Code plugins provide specialized skills for:

  • Metaschema authoring - Creating and validating Metaschema modules
  • OSCAL document creation - Building catalogs, profiles, SSPs
  • CLI assistance - Running commands and interpreting output
  • Metapath expressions - Writing and debugging queries
  1. Install Claude Code
  2. Install the Metaschema plugins

Skills for working with Metaschema definitions:

Skill Description
metaschema:metaschema-basics Introduction to Metaschema concepts
metaschema:metaschema-module-authoring Creating and modifying modules
metaschema:metaschema-constraints-authoring Defining validation constraints
metaschema:metapath-expressions Writing Metapath queries

Skills for working with OSCAL documents:

Skill Description
oscal:oscal-basics OSCAL document types and structure

Skills for using CLI and library tools:

Skill Description
oscal-tools:using-oscal-cli Running oscal-cli commands
metaschema-tools:using-metaschema-java Using the Metaschema Java library

For contributors to the Metaschema framework:

Skill Description
dev-metaschema:development-workflow TDD, debugging, testing patterns
dev-metaschema:repo-organization Project structure and relationships
dev-metaschema:unit-test-writing Writing comprehensive tests

Ask Claude:

“Help me set up the Maven plugin to generate Java classes from my Metaschema module”

Claude will guide you through the plugin configuration and code generation process.

Ask Claude:

“Help me write a Metapath expression that finds all controls with a specific property”

Claude will use the Metapath skill to construct and explain the expression.

Ask Claude:

“Validate my Metaschema module at src/main/metaschema/my-model.xml

Claude will run validation and explain any errors.

Ask Claude:

“I'm getting constraint validation errors. Can you help me understand what's wrong?”

Claude will analyze the errors, explain the constraint requirements, and suggest fixes.

  1. Be specific - Mention file paths and exact error messages
  2. Provide context - Share relevant portions of your Metaschema definitions
  3. Ask for explanations - Claude can explain why something is required by the specification
  4. Request examples - Ask for sample code or Metaschema snippets

When working with the Metaschema Java library, Claude can help you:

  • Configure the Maven plugin for code generation
  • Write code using generated binding classes
  • Execute Metapath queries programmatically
  • Implement custom constraint validators
  • Troubleshoot serialization and deserialization issues

For more information about Claude Code and the technologies used in this project: