Quick Example

Quick example (v0.2)

name: bobs-code-refactor
version: 1.2.0
description: |
  Takes a code snippet + language + task, produces refactored code with
  unit tests and documentation. Pin specific SKILL versions for
  reproducibility; declare MCP servers for future tool integration.
author_id: 0xBobAddress
author_name: Bob

price_usdc: 50000
license: MIT  # for the output

inputs:
  code: { type: string, required: true }
  language: { type: string, required: true, enum: [javascript, typescript, python, rust, go] }
  task: { type: string, required: true, enum: [refactor, add_tests, fix_bugs, document] }

output:
  format: zip
  files:
    - refactored_code.{ext}
    - tests.test.{ext}
    - README.md
  delivery: signed_url
  expires_in: 86400

quality:
  min_rating: 4.0
  refund_window: 24h

limits:
  total_tokens: 30000
  total_cost_usdc: 0.50
  timeout_seconds: 600

stages:
  - id: analyze
    model: gpt-4o
    input: { code: "$input.code", language: "$input.language", task: "$input.task" }
    output_format: structured_json
    fields: [issues, suggestions, complexity]   # post-LLM conformance check

  - id: refactor
    uses: code_rewriter@0.2.1                  # v0.2 NEW: version pin
    model: claude-3.5-sonnet
    depends_on: [analyze]
    input:
      code: "$input.code"
      language: "$input.language"
      suggestions: "$stages.analyze.output.suggestions"
    output_format: code

  - id: check_vulnerabilities
    uses: security_scanner                     # no pin → latest, emits provenance warning
    depends_on: [refactor]
    mcp_servers: [github]                      # v0.2 NEW: declared, not yet executed
    mcp_tools: [github_search, github_get_file]
    output_format: structured_json
    fields: [vulnerabilities, severity_counts]

  - id: write_files
    uses: file_writer@1.0.0
    working_dir: ./out                          # v0.2 NEW: CLI creates dir, FS ops available
    depends_on: [check_vulnerabilities]
    input:
      refactored: "$stages.refactor.output"
      tests: "$stages.test.output"
      readme: "$stages.document.output"

  - id: test
    uses: [test_generator, doc_writer]          # v0.1 syntax, still supported
    depends_on: [write_files]
    model: claude-3.5-sonnet