An Open Agent Skill for working with the ValueFlows 1.0 ontology: a vocabulary for describing economic activity in distributed networks.
Use this skill to map domain entities to VF classes, explain ontology concepts, generate typed code, and validate existing mappings against the VF 1.0 spec.
ValueFlows (VF) is a vocabulary for distributed economic networks that need to coordinate creation, distribution, and exchange of economic resources. It is grounded in REA (Resources, Events, Agents) accounting and covers:
- Core layer: EconomicResource, EconomicEvent, Agent, Process, Action, Measure
- Planning layer: Intent, Commitment, Claim, Plan
- Exchange layer: Agreement, Proposal
- Recipe layer: Recipe, RecipeProcess, RecipeFlow
The fundamental flow is: Intent → Commitment → EconomicEvent (planned → promised → observed).
Namespace: vf: = https://w3id.org/valueflows/ont/vf# · Version 1.0.0
Map any domain concept, data model, or field to a VF class and its properties.
Trigger phrases: "map to valueflows", "what vf class is", "map this entity"
Example:
"Map an invoice to ValueFlows"
Returns: class mapping table, property mapping table, and a JSON-LD example.
Explain any VF class or property in depth: definition, layer, when to use, relationships, and a concrete example.
Trigger phrases: "explain vf:", "what is vf class", "how does X work in valueflows"
Example:
"Explain the difference between vf:accountingQuantity and vf:onhandQuantity"
Returns: definition, layer, usage rules, contrasts with similar concepts, and a JSON-LD snippet.
Generate TypeScript interfaces, a GraphQL schema, or a JSON-LD @context document from VF classes.
Trigger phrases: "generate vf types", "typescript for vf", "graphql schema for vf", "json-ld context"
Example:
"Generate TypeScript interfaces for EconomicEvent, Agent, and Measure"
Returns: typed code in the requested format with VF IRI annotations and a mapping summary.
Validate an existing mapping (table, code, or JSON-LD) against the VF 1.0 spec.
Trigger phrases: "validate mapping", "check vf mapping", "is this correct vf"
Example:
"Validate this mapping: StockItem → vf:EconomicEvent, amount → vf:resourceQuantity"
Returns: a structured report with PASS / WARN / FAIL status per claim and corrective suggestions.
Follow the Open Agent Skills installation guide for your agent. For Claude Code, place the valueflows/ directory in your skills folder:
# Clone directly into your skills directory
git clone https://github.com/YOUR_USERNAME/valueflows ~/.claude/skills/valueflowsOr copy the folder manually.
valueflows/
├── SKILL.md # Skill metadata and workflow routing
├── ontology.md # Full VF 1.0 class and property reference (loaded on demand)
└── Workflows/
├── map-entity.md # Domain entity → VF class/property mapping
├── explain-concept.md # In-depth concept explanation
├── generate-types.md # TypeScript / GraphQL / JSON-LD generation
└── validate-mapping.md # Spec validation with PASS/WARN/FAIL report
| Class | Layer | Description |
|---|---|---|
vf:EconomicResource |
Core | Trackable thing (material, digital, currency) |
vf:EconomicEvent |
Core | Observed economic flow |
vf:Agent |
Core | Entity with economic agency (Person, Organization, EcologicalAgent) |
vf:Process |
Core | Activity transforming inputs to outputs |
vf:Intent |
Planning | Desired or estimated flow (one party) |
vf:Commitment |
Planning | Bilateral promise |
vf:Claim |
Planning | Future event owed in reciprocity |
vf:Plan |
Planning | Collection of scheduled processes |
vf:Agreement |
Exchange | Set of reciprocal commitments |
vf:Proposal |
Exchange | Published offer or request |
vf:Recipe |
Recipe | Template for planning a process |
- ValueFlows specification
- Ontology IRI
- TTL source
- hREA: Holochain implementation of ValueFlows
- Open Agent Skills spec
Ontology data: CC-BY-SA 4.0 (ValueFlows project)
Skill code: MIT