# Grace Ask

> Answer a question about a GRACE project using full project context. Use when the user has a question about the codebase, architecture, modules, or implementation — loads all GRACE artifacts, navigates the knowledge graph, and provides a grounded answer with citations.

- **Type:** Skill
- **Install:** `agentstack add skill-osovv-grace-marketplace-grace-ask`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [osovv](https://agentstack.voostack.com/s/osovv)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [osovv](https://github.com/osovv)
- **Source:** https://github.com/osovv/grace-marketplace/tree/main/skills/grace/grace-ask

## Install

```sh
agentstack add skill-osovv-grace-marketplace-grace-ask
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

Answer a question about the current GRACE project.

## Process

### Step 1: Load Project Context
Read the following files (skip any that don't exist):
1. `AGENTS.md` — project principles and conventions
2. `docs/knowledge-graph.xml` — module map, dependencies, exports
3. `docs/requirements.xml` — use cases and requirements
4. `docs/technology.xml` — stack, runtime, libraries
5. `docs/development-plan.xml` — phases, modules, contracts
6. `docs/verification-plan.xml` — tests, traces, log markers, and execution gates
7. `docs/operational-packets.xml` — canonical packet, delta, and failure handoff shapes

### Step 2: Identify Relevant Modules
Based on the question, find the most relevant modules:
1. Use the knowledge graph to locate modules related to the question
2. Follow CrossLinks to find connected modules
3. Read MODULE_CONTRACTs of relevant modules for detailed context
4. Read matching verification entries when the question is about behavior, failure modes, or testing

If the optional `grace` CLI is available, you may use:
- `grace module find  --path ` to resolve module IDs from names, paths, dependencies, or verification refs
- `grace module show M-XXX --path  --with verification` to pull the shared/public module snapshot
- `grace file show  --path  --contracts --blocks` to pull file-local/private context for the implementation details

### Step 3: Dive Into Code If Needed
If the question is about specific behavior or implementation:
1. Use MODULE_MAP to locate relevant functions/blocks
2. Read the specific START_BLOCK/END_BLOCK sections
3. Read function CONTRACTs for intent vs implementation details
4. Read nearby tests or log-marker assertions when they are the strongest evidence for expected behavior

### Step 4: Answer
Provide a clear, concise answer grounded in the actual project artifacts. Always cite which files/modules/blocks your answer is based on.

### Important
- Never guess — if the information isn't in the project artifacts, say so
- If the question reveals a gap in documentation or contracts, mention it
- If the question reveals a gap in tests, traces, or verification docs, mention it
- If the answer requires changes to the project, suggest the appropriate `$grace-*` skill

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [osovv](https://github.com/osovv)
- **Source:** [osovv/grace-marketplace](https://github.com/osovv/grace-marketplace)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-osovv-grace-marketplace-grace-ask
- Seller: https://agentstack.voostack.com/s/osovv
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
