SharpAgent Skill Contract v1.0.0

Foundation shovel — Generate, validate, and package all SharpAgent skills. Fusion of Ontology Schema + Skill Creator + Skill Oracle.

When to Use

Use this skill when:

• Creating a new SharpAgent-compliant Skill from scratch
• Validating an existing Skill for contract compliance
• Packaging a Skill for ClawHub publication under SharpAgent
• Upgrading a legacy Skill to SharpAgent standards

What Is a Skill Contract

Every SharpAgent Skill must declare a contract — a YAML block that states:

contract:
  name: sharpagent-five-factor-review
  version: "1.0.0"
  category: analysis
  trust_level: verified            # draft | verified | audited
  reads:
    - InformationSource
    - LearningEntry
  writes:
    - FiveFactorResult
  preconditions:
    - "Must have at least one InformationSource to analyze"
    - "Must have access to web_search or memory_search tool"
  postconditions:
    - "Output contains overall_confidence score (0-10)"
    - "Each of 5 factors has a value"
  calibration:
    default_mode: professional     # warm | professional | deep
    modes_supported: [warm, professional, deep]
  compliance:
    jurisdiction: global           # cn | us | eu | global
    safety_level: standard         # minimal | standard | strict
  lifecycle:
    status: active
    publish_as: SharpAgent

Workflow

Step 1: Scaffold a New Skill

sharpagent scaffold --name sharpagent-five-factor-review --category analysis

Generates:

/sharpagent-skills/sharpagent-five-factor-review/
├── SKILL.md            # Contract + documentation
├── contract.yaml       # Machine-readable contract (auto-derived)
├── scripts/            # Runtime scripts (optional)
├── references/         # Supporting docs (optional)
└── test/               # Validation tests (optional)

Step 2: Validate Contract

sharpagent validate --path ./sharpagent-five-factor-review/SKILL.md

Checks:

• Structural: All required YAML fields present
• Semantic: reads/writes match known ontology types
• Integrity: preconditions reference real capabilities
• Naming: snake_case, no spaces, max 40 chars

{
  "valid": true,
  "warnings": [],
  "errors": [],
  "score": 100,
  "missing_optional": ["scripts/ directory missing"]
}

Step 3: Package for Publication

sharpagent package --name sharpagent-five-factor-review --output ./dist/

Produces:

./dist/sharpagent-five-factor-review.tar.gz
├── SKILL.md
├── contract.yaml
├── scripts/
└── references/

Contract YAML Schema Reference

Top-Level Fields

Contract Categories

Trust Levels

Calibration Modes

calibration:
  default_mode: professional
  modes_supported: [warm, professional, deep]

Integration Points

With Five-Factor Review

• writes: [FiveFactorResult] → Contract schema is consumed by the five-factor review skill
• Contract trust_level is validated using FiveFactorResult as part of skill audit

With Calibration Framework

• contract.calibration block defines which modes are supported
• At runtime, the calibration engine checks contract.calibration.modes_supported

With Content Safety Engine

• contract.compliance block sets safety policies
• safety_level: standard is the minimum for ClawHub publication

Quality Gates

Edge Cases

Dependencies

• YAML parser (for reading contract blocks)
• jq or Python 3 (for validation scripts)
• tar (for packaging)

Version History

• v1.0.0 — Initial release. Skill Contract scaffolding + validation + packaging.

SharpAgent · MIT-0 · 2026-05-11