document-feature
Use when the user asks to document an implemented feature, before or after its changes are committed, in the repository's existing documentation structure or under docs/features/ when none exists.
How do I install this agent skill?
npx skills add https://github.com/folio-org/folio-eureka-ai-dev --skill document-featureIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill automates feature documentation by analyzing local code changes and git diffs. It performs file system reads and writes and instructs the agent to execute git commands. A minor risk of indirect prompt injection exists if the code being analyzed contains adversarial content, which is a standard risk for development tools.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
2/3 files flagged
What does this agent skill do?
Document Feature
You are a documentation specialist. After implementing a feature, analyze the code changes and generate behavioral feature documentation.
Scope and assumptions (this skill is intentionally scoped)
This skill targets backend modules with these common characteristics:
- Java service built on Spring (Spring MVC) or Quarkus (JAX-RS)
- PostgreSQL persistence
- REST API documented in OpenAPI YAML (preferred source of truth for endpoints)
- Kafka used for message consumption/production
- Deployed as multiple instances behind a load balancer (clustered)
If a repo deviates, proceed best-effort but follow the evidence rules.
Non-negotiables
Feature = observable behavior
A feature is what external consumers can observe or interact with. Implementation mechanisms are aspects of features.
| Feature (behavior) | Aspect (mechanism) |
|---|---|
| Resource lookup API | Cache for lookup |
| Validation rules | Exception mapping |
| Event-driven state sync | Kafka listener wiring |
Name features after behavior, not the mechanism:
- Good:
resource-lookup,hold-request-validation,tenant-sync-processing - Bad:
resource-cache,validation-refactor,kafka-handler
Evidence-only rule (no guessing)
Only document endpoints/topics/config/integrations that you can point to in repo evidence:
- OpenAPI spec (
*.yml/*.yamlcontainingopenapi:orswagger:) - Application config (
application.yml,application.yaml,application.properties) - Code evidence (annotations, constants, clearly named configuration keys)
- README or other checked-in docs
If you cannot prove it, omit it. Do not infer "likely" dependencies.
Questions
- Write/update docs immediately.
- Ask a targeted question only when the base, documentation structure, or feature boundary/name is genuinely ambiguous; propose the choice you would use.
- If changes are clearly refactoring/formatting/tests-only with no observable behavior change: stop and report that no feature doc update is needed.
Outputs
Write where the repository already documents behavior. Before writing, look for an established
structure: docs/features/ with docs/features.md, or another feature, behavior or API
documentation layout under docs/, doc/, or the README.
docs/features/already exists, or there is no established structure: for each affected feature, writedocs/features/<feature_id>.md(create directories if missing) and thedocs/features.mdindex (create if missing; if present, update minimally in existing style).- Another structure is established: update or add the matching document in that structure,
following its file naming, headings, and index. Do not create
docs/features/next to it. Use the section content below, adapted to that structure's headings. - Two structures are plausible: ask one question, proposing the one you would use.
Feature doc frontmatter
In the docs/features/ layout, feature docs must include exactly these required frontmatter fields:
feature_id: must equal the file name (without.md)title: human-readable Title Caseupdated:YYYY-MM-DD(use today)
Existing docs may have extra frontmatter keys; preserve them. Do not add new keys (for example, do not introduce owners).
If an existing doc's feature_id does not match the filename: update feature_id to match the filename (do not rename files).
Documentation structure (fixed order; omit non-applicable sections)
In the docs/features/ layout, each feature document lives at docs/features/<feature_id>.md using this template.
---
feature_id: <kebab-case-id>
title: <Human Title>
updated: <YYYY-MM-DD>
---
# <Human Title>
## What it does
<2-3 sentences describing observable behavior from an external perspective.>
## Why it exists
<Business rationale: what problem it solves and why this behavior matters.>
## Entry point(s)
<Choose the relevant entry point representation(s). Omit only if the feature has no clear entry point.>
## Business rules and constraints
- <Rule 1 in plain language>
- <Rule 2>
## Error behavior (if applicable)
- <Externally visible error conditions and outcomes: status codes, validation failures, retry/idempotency expectations.>
## Caching (if applicable)
<Document caching only when it affects externally observable behavior or operational correctness in a cluster.>
## Configuration (if applicable)
| Variable | Purpose |
|----------|---------|
| <property.key or ENV_VAR> | <What it controls in this feature> |
## Dependencies and interactions (if applicable)
<Only feature-relevant, evidenced external interactions.>
For entry point format templates (REST, Kafka Consumer, Scheduled Job, Internal Event), see references/entry-point-templates.md.
The index file (docs/features.md)
Only in the chosen docs/features/ layout: if docs/features.md does not exist, create a minimal index:
# Module Features
This module provides the following features:
| Feature | Description |
|---------|-------------|
| [<Human Title>](features/<feature_id>.md) | <One-sentence behavioral description> |
If it exists but uses a different format, update minimally in the existing style (do not rewrite/normalize).
For detailed workflow steps (preflight and change candidate, feature identification, entry points, behavior extraction, configuration, dependencies), see references/workflow.md.
Quick sanity checks
- Feature names reflect behavior (not caching/events/implementation).
- Every endpoint/topic/config/integration mentioned is backed by evidence.
- In the
docs/features/layout, sections follow the fixed order; non-applicable sections are omitted. In other layouts, preserve the existing headings and order. - Docs were written in the repository's existing documentation structure, or in
docs/features/only when none existed.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/folio-org/folio-eureka-ai-dev/document-feature">View document-feature on skillZs</a>