Agent Skills

Dimebia exposes first-class agent skills so AI assistants and automation workflows can operate payments, billing, and developer resources through structured interfaces instead of raw HTTP calls.

What is an Agent Skill?

An agent skill is a capability bundle that includes:

• Intent: what the skill accomplishes
• Inputs / Outputs: typed schemas for requests and responses
• Auth: required permissions or API key scope
• Safety: rate limits, approval requirements, and audit hooks

Why Use Skills?

Approach	Pros	Cons
Raw REST calls	Full control	Verbose, brittle, hard to validate
SDKs	Type safe	Still imperative
Agent Skills	Declarative, validated, auditable	Requires skill-aware runtime

Core Skills

Skill	Description
payment.create	Create and authorize a payment
payment.refund	Refund a transaction
invoice.create	Generate an invoice
subscription.update	Modify a subscription
channel.list	Discover available channels
transaction.search	Search transactions with filters
report.billing	Generate billing reports

Skill Manifest

Each skill is described by a manifest:

{
  "skill": "payment.create",
  "version": "1.0",
  "description": "Create a payment transaction",
  "input": {
    "amount": "long",
    "currency": "string",
    "channelId": "long",
    "description": "string?"
  },
  "output": {
    "id": "string",
    "status": "string",
    "createdTime": "string"
  },
  "auth": {
    "scopes": ["transaction_write"]
  },
  "safety": {
    "maxAmount": 1000000000,
    "requireApproval": false
  }
}

Using Skills

Skills can be invoked via:

• REST endpoint: POST /v1/skills/payment.create
• SDK helper: client.skills.payment.create(...)
• Webhook event: trigger on skill.invoked

Security

• Every skill invocation is audited
• Scopes are enforced at runtime
• Sensitive fields are masked in logs