# Update Public Docs

> Update public API reference docs to match Python source code. Compares client.py, schema files, and config models against MDX docs and fixes any gaps. Triggers on: update docs, sync docs, update public docs, update api reference, refresh documentation.

- **Type:** Skill
- **Install:** `agentstack add skill-reflexioai-claude-smart-update-public-docs`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ReflexioAI](https://agentstack.voostack.com/s/reflexioai)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [ReflexioAI](https://github.com/ReflexioAI)
- **Source:** https://github.com/ReflexioAI/claude-smart/tree/main/.claude/skills/update-public-docs
- **Website:** https://www.reflexio.ai/docs/claude-smart

## Install

```sh
agentstack add skill-reflexioai-claude-smart-update-public-docs
```

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

## About

# Update Public Docs

Keep the public documentation at `reflexio/public_docs/` in sync with the Python source code (client library, schemas, config models).

## Source Files (authoritative)

Read these files to understand the current API surface:

- `reflexio/reflexio_client/reflexio/client.py` — All public client methods (defines what's client-facing)
- `reflexio/reflexio_commons/reflexio_commons/api_schema/service_schemas.py` — Data models, enums, request/response schemas
- `reflexio/reflexio_commons/reflexio_commons/api_schema/retriever_schema.py` — Search/get request/response models
- `reflexio/reflexio_commons/reflexio_commons/config_schema.py` — Configuration models

## Documentation Files (to update)

Read all MDX docs under `reflexio/public_docs/content/docs/`:

- `api-reference/client-*.mdx` — Client method documentation
- `api-reference/schemas-*.mdx` — Schema/model documentation
- `concepts/` — Core concept pages
- `getting-started/` — Quickstart and setup guides
- `examples/` — Usage examples

## Workflow

### Step 1: Read All Sources

Read every source file listed above. Extract:
- All public methods from `ReflexioClient` (name, parameters with types/defaults, return type, docstring)
- All public Pydantic models used by those methods (field name, type, required/optional, default, description)
- All enum classes and their values
- All config model fields

### Step 2: Read All Documentation

Read every MDX file under `reflexio/public_docs/content/docs/`.

### Step 3: Compare and Update

For each doc category, compare source against docs and fix discrepancies:

**Client methods** (`client-*.mdx`):
- Every public method in `client.py` must be documented
- Parameters: correct name, type, required/optional, default value
- Return type and response schema must match
- Remove docs for methods that no longer exist

**Schema docs** (`schemas-*.mdx`):
- Every field in each Pydantic model must appear in the documentation tables
- Field name, type, required/optional, default, and description must match source
- Remove docs for models/fields that no longer exist

**Enums** (`schemas-enums.mdx`):
- All enum values must be listed with correct string values

**Config docs** (`schemas-config.mdx`):
- All config model fields must match source

**Concepts/examples** (`concepts/`, `getting-started/`, `examples/`):
- Check for references to deprecated or renamed features, methods, or fields
- Update any stale code snippets

### Step 4: Scope Rules

**INCLUDE:**
- All methods in `ReflexioClient`
- All public Pydantic models used by those methods
- All enums
- Config models

**EXCLUDE:**
- Internal API endpoints (`api.py` internals) — only document what's exposed through `client.py`
- Skill-related features (disabled)
- Private/internal helper methods
- Implementation details

### Step 5: Verify Build

Run the docs build to ensure no errors:

```bash
cd reflexio/public_docs && npx next build
```

Fix any build errors before finishing.

### Step 6: Report

Summarize what changed:
- New methods/models/fields documented
- Updated parameters, types, or defaults
- Removed stale documentation
- Any build issues encountered and how they were resolved

## Source & license

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

- **Author:** [ReflexioAI](https://github.com/ReflexioAI)
- **Source:** [ReflexioAI/claude-smart](https://github.com/ReflexioAI/claude-smart)
- **License:** Apache-2.0
- **Homepage:** https://www.reflexio.ai/docs/claude-smart

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-reflexioai-claude-smart-update-public-docs
- Seller: https://agentstack.voostack.com/s/reflexioai
- 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%.