Skip to content
Get packs

BDI Mental State Modeling

Models agent beliefs, desires and intentions as linked RDF data for explainable reasoning

Source Download skill
Repository
muratcankoylan/Agent-Skills-for-Context-Engineering
Stars
18,282
Licence
MIT
Files
5 files

What it does

This skill teaches an AI agent to represent its internal state as formal BDI (Belief-Desire-Intention) structures, using RDF/Turtle ontology patterns. Once installed, when asked to convert external structured data into agent beliefs or to make the agent's reasoning traceable, the agent follows the skill's patterns for linking beliefs to world states, desires to motivating beliefs, and intentions to plans and justifications. The output is machine-readable linked data meant for multi-agent or semantic systems rather than ordinary chat answers.

Great for

  • Developers building BDI or multi-agent systems (e.g. JADE, JADEX, SEMAS) who want RDF-based mental state models
  • Researchers working on neuro-symbolic AI or Logic Augmented Generation who need explainable reasoning traces
  • Engineers integrating semantic web data (RDF, SPARQL) into agent decision-making

Skip it if

  • General users wanting ordinary reasoning help: the skill is specialised formal ontology modelling and adds complexity with no benefit for everyday tasks
  • Persistent user memory or conversation history: the skill's own guidance says to use a different skill (memory-systems) for that
  • Evaluating agent quality or designing multi-agent topologies: the skill redirects these to other skills (evaluation, multi-agent-patterns)

Try asking

  • “Convert this JSON-LD event feed into beliefs and intentions for my BDI agent in Turtle”
  • “Model my agent's decision to reschedule a meeting as linked Belief, Desire and Intention triples with justifications”
  • “Write a SPARQL query that finds all intentions whose supporting beliefs have expired”
  • “Explain how to wire a JADEX agent's perception cycle to an RDF world-state store”
Step-by-step guide: how to use BDI Mental State ModelingInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 5 original files, the MIT licence and an attribution note.

    bdi-mental-states.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip bdi-mental-states.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip bdi-mental-states.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Provide your domain's existing RDF vocabulary or ontology so the output reuses your terms instead of the generic bdi: namespace.
  • State which C4 level you are modelling (context, container, component or code) so the notation choice matches the skill's guidance.
  • Ask for SPARQL competency questions alongside the model to check that the ontology actually answers the queries you need.

What's inside

  • references/bdi-ontology-core.md
  • references/framework-integration.md
  • references/rdf-examples.md
  • references/sparql-competency.md
  • SKILL.md

Redistributed unmodified from muratcankoylan/Agent-Skills-for-Context-Engineering under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.