Skip to content
Back to skills

2655 Contextual Ai Documentation Optimizer Adapter 394973bd

ASecurity

`plugins/plugin-creator/agents/contextual-ai-documentation-optimizer.md`

  • 9 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added October 11, 2026
ai-agentsdocumentation

Security analysis

A100/100

Scanned October 11, 2026

npx -y skills add tools-only/X-Skills --skill 2655-contextual-ai-documentation-optimizer-adapter_394973bd --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of 2655 Contextual Ai Documentation Optimizer Adapter 394973bd?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for 2655 Contextual Ai Documentation Optimizer Adapter 394973bd
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/tools-only-2655-contextual-ai-documentation-optimizer-adapter/badge)](https://www.skillsdirectory.com/skills/tools-only-2655-contextual-ai-documentation-optimizer-adapter)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

SKILL.md
---
adapter: contextual-ai-documentation-optimizer-adapter
wraps: plugins/plugin-creator/agents/contextual-ai-documentation-optimizer.md
normalizes_to: optimization-block-v1
version: "1.0"
---

# contextual-ai-documentation-optimizer Adapter

## Wrapped Component

`plugins/plugin-creator/agents/contextual-ai-documentation-optimizer.md`

This agent produces a multi-section output: RT-ICA assessment, optimized content, CoVe verification, and token impact report. Output is a STATUS: DONE or BLOCKED block with the optimized content inline or written to file.

## Native Output Contract

The agent produces:

1. RT-ICA pre-check assessment
2. Optimized file content (written in-place or to specified path)
3. CoVe post-check verification (did the output meet the objectives?)
4. Token impact report (before/after token counts)
5. STATUS: DONE or BLOCKED

## Adapter Transformation

The adapter maps the native output to `optimization-block-v1`:

```text
STATUS: DONE|BLOCKED|FAILED
SUMMARY: [what was optimized — extracted from agent's STATUS summary]
ARTIFACTS:
  - {optimized-file-path}
VALIDATION:
  - frontmatter-validator: PASS|FAIL
  - prompt-structure-validator: PASS|FAIL
DIFF:
  tokens_before: N
  tokens_after: N
  delta: +N / -N
  prohibitions_converted: N
NOTES: [CoVe verification notes, if any issues found]
```

## Validators Added by Adapter

- `frontmatter-validator` — re-runs after optimization to confirm frontmatter is still valid
- `prompt-structure-validator` — checks that prohibition patterns were converted to positive alternatives

## BLOCKED Mapping

If the agent returns BLOCKED (typically due to RT-ICA pre-check failure), the adapter preserves the BLOCKED status. The RT-ICA failure reason is placed in NOTES. The user must provide the missing input before re-running.

## Token Impact Data

The adapter extracts token counts from the agent's token impact report. If the optimized content increased token count by more than 10%, the NOTES field includes a flag: "Token count increased — review before committing."

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.