Skill: mindbomber/aana-research-grounding (version 1.0.0)

# AANA Research Grounding Skill Use this skill when an OpenClaw-style agent drafts a research answer, literature note, report section, cited summary, evidence brief, or knowledge-base answer that must stay inside known sources. This is an instruction-only skill. It does not install packages, run commands, write files, call remote services, persist memory, or execute a checker on its own. ## Core Principle Every important claim must stay attached to the evidence that supports it. The agent should separate: - what the sources support, - what the sources do not support, - what is uncertain, - what would require more retrieval or human review. ## When To Use Use this skill before producing or publishing: - cited answers, - research summaries, - literature-review notes, - technical explainers, - policy or legal-adjacent briefs, - scientific or medical-adjacent summaries, - internal knowledge-base answers, - meeting or document syntheses, - public claims based on limited source material. ## Grounding Loop 1. Source list: identify the sources the answer is allowed to use. 2. Claim list: list the answer's main factual claims. 3. Citation check: verify each claim is supported by an allowed source. 4. Boundary check: remove or label any claim based on missing, forbidden, stale, private, or uncertain evidence. 5. Uncertainty check: state source limits before confident conclusions when evidence is incomplete. 6. Correction: revise, retrieve, ask, defer, or refuse when claims cannot be grounded. 7. Final gate: only provide the answer once unsupported claims, invented citations, and missing caveats are resolved. ## AANA Constraint Map - Physical / factual: no invented citations, no fake studies, no unsupported numbers, no impossible facts. - Human impact: do not create false confidence, especially in health, legal, financial, safety, or public-facing contexts. - Constructed / task: use only the requested source set, citation style, scope, and output format. - Feedback integrity: distinguish sourced claims, inference, speculation, and missing evidence. ## Citation Rules - Cite only sources that are actually available in the task context. - Do not invent titles, authors, URLs, dates, page numbers, quotes, statistics, or benchmark results. - Do not cite a source for a claim it does not support. - If source coverage is incomplete, say so. - If a claim needs retrieval, recommend retrieval instead of guessing. - If the user asks for a source-bounded answer, do not use outside knowledge unless explicitly allowed. ## Source Boundary Rules Treat these as violations: - using a forbidden source, - using private or unrelated user data, - treating search snippets as full evidence without noting the limit, - treating one source as broad consensus, - upgrading a hypothesis into a result, - presenting outdated information as current, - preserving a citation while changing the claim beyond what the source supports. ## Uncertainty Language Use clear uncertainty labels: - "The provided sources support..." - "The provided sources do not establish..." - "I cannot verify from the provided evidence..." - "This is an inference, not a directly sourced claim..." - "More retrieval is needed before claiming..." Avoid false certainty: - "proves" - "guarantees" - "all experts agree" - "studies show" without naming the source - exact percentages not present in the evidence ## Review Payload When using a configured AANA checker, send only a minimal redacted review payload: - `task_summary` - `allowed_sources` - `claim_summaries` - `citation_summaries` - `unsupported_or_uncertain_claims` - `recommended_action` Do not include private records, secrets, paywalled full text, API keys, unrelated user messages, or raw source material when a summary is enough. ## Decision Rule - If every important claim is supported by allowed sources, answer with citations. - If a claim is unsupported but fixable, revise. - If evidence is missing, retrieve or ask. - If the user requires a source-bounded answer and the evidence is insufficient, say what cannot be concluded. - If the answer would create high-impact false confidence, defer or ask for human review. - If a checker is unavailable or untrusted, use manual review. ## Output Pattern For source-grounded answers, prefer: ```text Answer: - ... Evidence: - [Source A] supports ... - [Source B] supports ... Limits: - The provided sources do not show ... - Uncertainty remains about ... ``` Keep the answer useful, but never make unsupported confidence look like evidence.

path: manifest.json
content: {
  "name": "aana-research-grounding",
  "slug": "aana-research-grounding",
  "version": "0.1.0",
  "type": "instruction_only_skill",
  "description": "AANA-grounded research instructions for checking citations, source limits, unsupported claims, uncertainty, and evidence boundaries.",
  "entrypoint": "SKILL.md",
  "bundled_code": false,
  "installs_dependencies": false,
  "executes_commands": false,
  "writes_files": false,
  "writes_event_files": false,
  "persists_memory": false,
  "requires_user_approval_for_persistence": true,
  "data_handling": {
    "prefer_redacted_summaries": true,
    "store_payloads_by_default": false,
    "requires_redaction": true,
    "forbidden_payload_content": [
      "API keys",
      "bearer tokens",
      "passwords",
      "private records unrelated to the research task",
      "paywalled full text copied without permission",
      "unrelated user messages"
    ]
  },
  "research_grounding_boundary": {
    "must_use_allowed_sources_only": true,
    "must_not_invent_citations": true,
    "must_not_invent_quotes": true,
    "must_not_invent_statistics": true,
    "must_label_uncertainty": true,
    "must_distinguish_source_claims_from_inference": true,
    "must_retrieve_or_ask_when_evidence_is_missing": true,
    "may_not_expand_source_scope_without_permission": true
  },
  "aana_boundary": {
    "checker_bundled": false,
    "checker_required": false,
    "allowed_checker_interfaces": [
      "approved host tool configured by the user or administrator",
      "approved in-memory API connector configured by the user or administrator",
      "manual review"
    ]
  },
  "schemas": [
    "schemas/research-grounding-review.schema.json"
  ],
  "examples": [
    "examples/redacted-research-grounding-review.json"
  ]
}


path: README.md
content: # AANA Research Grounding Skill

This OpenClaw-style skill helps agents check citations, source limits, unsupported claims, uncertainty, and evidence boundaries before producing research or knowledge-work answers.

## Marketplace Slug

Recommended slug:

```text
aana-research-grounding
```

## Contents

- `SKILL.md`: agent-facing instructions.
- `manifest.json`: review metadata and boundaries.
- `schemas/research-grounding-review.schema.json`: optional review-payload shape.
- `examples/redacted-research-grounding-review.json`: safe example payload.

## What It Does

The skill asks the agent to:

1. Identify allowed sources.
2. List important claims.
3. Check whether each claim is supported by an allowed source.
4. Remove, revise, retrieve, ask, defer, or label uncertainty when evidence is missing.
5. Preserve source boundaries and avoid false confidence.

## What It Does Not Do

This package does not:

- install dependencies,
- execute code,
- call remote services,
- write files,
- persist memory,
- create citations,
- retrieve sources on its own.

## Safety Model

The agent should never invent sources, quotes, page numbers, statistics, benchmark results, or consensus language. When evidence is incomplete, the answer should say what the provided sources do and do not support.

Use redacted summaries for review payloads. Do not include secrets, tokens, passwords, unrelated private records, or full source text when a summary is enough.


path: schemas/research-grounding-review.schema.json
content: {
  "title": "AANA Research Grounding Review",
  "type": "object",
  "required": [
    "task_summary",
    "allowed_sources",
    "claim_summaries",
    "recommended_action"
  ],
  "properties": {
    "task_summary": {
      "type": "string",
      "minLength": 1
    },
    "allowed_sources": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "string"
      }
    },
    "claim_summaries": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "claim",
          "support_status"
        ],
        "properties": {
          "claim": {
            "type": "string"
          },
          "support_status": {
            "type": "string",
            "enum": [
              "supported",
              "unsupported",
              "uncertain",
              "needs_retrieval",
              "forbidden_source"
            ]
          },
          "source_refs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "notes": {
            "type": "string"
          }
        },
        "additionalProperties": false
      }
    },
    "citation_summaries": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "unsupported_or_uncertain_claims": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "recommended_action": {
      "type": "string",
      "enum": [
        "accept",
        "revise",
        "retrieve",
        "ask",
        "defer",
        "refuse"
      ]
    },
    "uncertainty_label_required": {
      "type": "boolean"
    },
    "source_scope": {
      "type": "string",
      "enum": [
        "provided_sources_only",
        "retrieval_allowed",
        "manual_review_required"
      ]
    }
  },
  "additionalProperties": false
}


path: examples/redacted-research-grounding-review.json
content: {
  "task_summary": "Draft a short research answer from two provided source notes.",
  "allowed_sources": [
    "Source A",
    "Source B"
  ],
  "claim_summaries": [
    {
      "claim": "AANA-style verifier loops can make constraints explicit.",
      "support_status": "supported",
      "source_refs": [
        "Source A"
      ],
      "notes": "Supported by the provided source note."
    },
    {
      "claim": "AANA improves productivity by a precise percentage.",
      "support_status": "unsupported",
      "source_refs": [],
      "notes": "No provided source includes a measured productivity percentage."
    }
  ],
  "citation_summaries": [
    "Use only Source A and Source B."
  ],
  "unsupported_or_uncertain_claims": [
    "Precise productivity percentage is unsupported."
  ],
  "recommended_action": "revise",
  "uncertainty_label_required": true,
  "source_scope": "provided_sources_only"
}


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)