CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bdi-mental-states

This skill should be used when the user asks to "model agent mental states", "implement BDI architecture", "create belief-desire-intention models", "transform RDF to beliefs", "build cognitive agent", or mentions BDI ontology, mental state modeling, rational agency, or neuro-symbolic AI integration.

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/bdi-mental-states/SKILL.md

The canonical home for this skill is bdi-mental-states in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

53%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-organized pattern catalog with genuinely concrete Turtle and SPARQL examples for a specialized ontology domain, weakened by basic BDI theory explanations Claude already knows and a broken references section that advertises four detailed documentation files that do not exist. The T2B2T workflow is present but scattered rather than operationalized.

Suggestions

Either create the four referenced files in references/ or remove the References section — currently every referenced path is dangling, which actively misleads navigation.

Trim the Core Concepts section: Claude already knows what beliefs, desires, intentions, and the endurant/perdurant distinction are; keep only the bdi: vocabulary mapping.

Promote the T2B2T paradigm into an explicit numbered workflow with a validation step (e.g., run the competency questions after generating triples) instead of leaving it split between a section and guideline #8.

DimensionReasoningScore

Conciseness

The ontology-specific patterns (bdi: vocabulary, T2B2T, notation table) earn their tokens, but the Core Concepts section re-explains basic BDI theory Claude already knows ('Belief: What the agent believes to be true about the world', DOLCE endurant/perdurant distinctions), and the intro paragraph pads with buzzphrases like 'supporting deliberative reasoning, explainability, and semantic interoperability'. This matches anchor 3 (mostly efficient but includes some unnecessary explanation or could be tightened) rather than 4, since multiple sections could be trimmed.

3 / 5

Actionability

Most guidance is concrete and copy-adaptable: complete Turtle patterns for the cognitive chain, world-state grounding, temporal validity, and executable SPARQL competency questions. The Python LAG example calls undefined helpers (serialize_ontology, extract_rdf_triples, retry_with_feedback) and the SEMAS Prolog uses illustrative custom syntax, which are minor gaps — fitting anchor 4 (mostly executable guidance with minor gaps) rather than 5's fully copy-paste-ready coverage.

4 / 5

Workflow Clarity

A three-phase sequence exists (T2B2T: translate RDF to beliefs, execute BDI reasoning, project back to RDF) and the competency questions act as a validation checkpoint, but the sequence is scattered between the T2B2T section and guideline #8 rather than presented as an operational workflow, and there are no explicit error-recovery or checkpoint steps in the main flow. This fits anchor 3 (steps listed but validation gaps; sequence present but checkpoints implicit) better than 4's clear sequence with most checkpoints present.

3 / 5

Progressive Disclosure

The References section points to four files ('bdi-ontology-core.md', 'rdf-examples.md', 'sparql-competency.md', 'framework-integration.md') but no references/ directory or bundle files exist — every referenced path is dangling. Meanwhile the complete RDF examples and full competency queries are inlined in the body anyway, fitting anchor 2 (content that clearly belongs in separate files is inlined) combined with references that mislead rather than aid navigation; this keeps it below anchor 3's 'references present' with genuine structure behind them.

2 / 5

Total

12

/

20

Passed

Description

81%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A trigger-rich description for a well-defined niche, with excellent keyword and synonym coverage and an explicit use-when clause. Its main weakness is that the 'what' — what the skill actually does or produces — is never stated directly, only implied through quoted trigger phrases that all describe the same modeling activity.

Suggestions

Add an explicit capability statement before the trigger clause, e.g., 'Transforms external RDF context into BDI mental states (beliefs, desires, intentions) as ontology triples, with validation SPARQL competency queries. Use when...'

Differentiate the trigger phrases' implied actions from actual deliverables so the description answers 'what does this do' directly rather than only 'when to use it'.

DimensionReasoningScore

Specificity

The description names several action phrases ("model agent mental states", "transform RDF to beliefs", "implement BDI architecture") but these all describe the same single modeling activity, and there is no standalone statement of concrete capabilities or outputs (e.g., generating BDI ontology triples, SPARQL competency queries). It sits between anchor 3 (domain plus 1-2 concrete actions, not comprehensive) and anchor 4; the action coverage is too narrow and trigger-phrased to reach 4.

3 / 5

Completeness

The "when" is fully explicit ("This skill should be used when the user asks to...") with concrete trigger phrases, but the "what" is only implied through those trigger phrases rather than stated as a capability description. Anchor 4 ("both 'what' and 'when'; 'when' could be more explicit or specific") is inverted here — the 'when' is stronger than the 'what' — which keeps it below anchor 5's clear and explicit answer to both.

4 / 5

Trigger Term Quality

Quoted natural phrases ("model agent mental states", "implement BDI architecture", "create belief-desire-intention models", "transform RDF to beliefs", "build cognitive agent") plus mention triggers (BDI ontology, mental state modeling, rational agency, neuro-symbolic AI integration) comprehensively cover the niche domain with synonyms and both abbreviated and expanded forms. This matches anchor 5's comprehensive synonym coverage; no natural user phrasing for this domain is obviously missing.

5 / 5

Distinctiveness Conflict Risk

BDI, belief-desire-intention, mental state modeling, and rational agency form a clear niche with distinct triggers; no other common skill category would match these phrases. This matches anchor 5 (clear niche, distinct triggers, minimal conflict risk).

5 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/bdi-mental-states/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.