One-click install
npx skills add https://github.com/diazMelgarejo/orama-system --skill afrp-diazmelgarejo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: afrp
Source: https://github.com/diazMelgarejo/orama-system/tree/main/bin/orama-system/afrp
Command: npx skills add https://github.com/diazMelgarejo/orama-system --skill afrp-diazmelgarejo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI agents often generate misaligned responses because they skip intent classification and jump straight to output, producing answers calibrated to the wrong audience, wrong depth, or wrong interpretation. AFRP prevents this by enforcing a mandatory pre-routing gate that classifies every query before any execution begins. ## Core Features & Use Cases - Query Classification Gate: Classifies incoming queries on two axes — Type (A factual, B analytical, C implementation, D ambiguous) and Audience Level (Novice, Practitioner, Expert) — then maps them to the appropriate oramasys execution mode. - Intent-Verification Gate: Forces a stop-and-clarify check on interpretation risk, before negative conclusions, when explicit instructions conflict with assumptions, and when decisions depend on mutable external state like live PR or branch status. - Failure Mode Taxonomy: Ships an extended reference documenting ten failure modes (personalized slop, abstraction mismatch, handwaving, stale authority snapshots, and more) with recovery procedures. - Use Case: Before an agent answers "write guidance for small business owners on tariffs," AFRP classifies it as Type B for a novice audience, declares the scope explicitly, and calibrates the response to operational steps instead of abstract frameworks. ## Quick Start Ask the agent to run the AFRP gate on your query before generating any non-trivial response, for example: "Classify this request with AFRP, then answer it."

Frequently Asked Questions about afrp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I classify user queries before generating AI agent responses?

Use a two-axis classification gate: assign the query a type (factual, analytical, implementation, or ambiguous) and an audience level (novice, practitioner, expert). Declare the classification explicitly, then route to the matching execution mode before generating output.

What is the AFRP gate in the orama-system workflow?

AFRP is the mandatory pre-router gate that runs before the Execution Mode Router in orama-system. It classifies query type and audience level, declares scope, and calibrates output depth before any of the five methodology stages begin.

How do I prevent AI agents from answering ambiguous questions incorrectly?

Apply an intent-verification step that forces the agent to stop and clarify when a request has two or more interpretations. The agent should ask the user to confirm the desired end-state rather than acting on its best guess.

Why do AI agents give wrong answers about pull request or branch status?

Agents often rely on remembered conversation state instead of querying the live authority. PRs merge and branches advance after the snapshot was recorded, so the agent must query GitHub immediately before deciding or writing.

When should an AI agent ask clarifying questions instead of answering?

The agent should ask first when a query is ambiguous (Type D), when the user insists something exists that a first check denies, or when an explicit instruction conflicts with the agent's assumption. Clarifying costs one turn; a wrong answer costs more.