update-docs

Updates technical documentation to reflect implemented changes using selective context loading.

Updated Jun 11, 2026
One-click install
npx skills add https://github.com/Marcel-Carrillo/ProyectosIA --skill update-docs-marcel-carrillo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: update-docs
Source: https://github.com/Marcel-Carrillo/ProyectosIA/tree/main/ai-specs/skills/update-docs
Command: npx skills add https://github.com/Marcel-Carrillo/ProyectosIA --skill update-docs-marcel-carrillo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Implemented code changes often leave project documentation stale, causing API specs, data models, and setup guides to drift from actual behavior. This Skill identifies which documentation files are affected by a change and updates only those files, keeping docs accurate without wasting tokens on irrelevant context. ## Core Features & Use Cases - Selective Context Loading: Reads only the documentation files relevant to the change type (data model, API, backend, frontend, or OpenSpec workflow) instead of loading everything. - Ecommerce Consistency Validation: Verifies that documentation preserves domain rules such as separating CustomerOrder from SupplierOrder and hiding supplier data from customer-facing APIs. - Structured Update Report: Produces a summary of changed and unchanged documentation plus alignment checks against the data model, API spec, and standards. - Use Case: After adding a new endpoint for return requests, run this Skill to update docs/api-spec.yml and docs/data-model.md while confirming no customer-facing exposure of supplier fields. ## Quick Start Ask the AI to review the recently implemented changes and update any affected project documentation using the update-docs skill.

Frequently Asked Questions about update-docs

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

FAQPage Schema
How do I keep project documentation in sync with code changes?▼

Use this Skill after implementing a feature or change. It classifies the change type, reads only the relevant documentation files, and applies minimal targeted updates so docs like api-spec.yml and data-model.md stay aligned with the implementation.

How to update OpenAPI spec after changing API endpoints?▼

When endpoints, request bodies, response schemas, or status codes change, the Skill reads and updates docs/api-spec.yml only. It also checks that customer-facing exposure rules are preserved, such as hiding supplier costs from public API responses.

Does this Skill work without Jira or GitHub integrations?▼

Yes, it is designed for local and private project workflows. It does not require Jira, Sentry, GitHub MCP, or any external system, and its guardrails explicitly prohibit updating external tools.

When should I not use a documentation update skill?▼

Do not use it for purely exploratory discussions where no change was implemented, unless the user explicitly asks for documentation updates. It also refuses to change architecture, tech stack, or business model assumptions without explicit approval.

What happens if documentation is already accurate?▼

The Skill makes no edits and reports that no documentation updates are required. This avoids unnecessary rewrites and keeps documentation changes traceable to actual implemented changes.