Skip to content
cccskills
FreePublished on GitHub

deepchat-sdd-cleanup

Clean up DeepChat's specification-driven development documents after implementation and validation. Review feature, issue, and architecture files, remove completed or obsolete material when evidence supports deletion, and preserve maintained specifications while checking references.

OriginalShow the original description

Use only when a developer explicitly asks to clean, prune, tidy, or organize DeepChat SDD documentation after implementation and validation. Scans docs/features, docs/issues, and docs/architecture; prefers multi-agent review when available; removes completed issue docs when a linked GitHub issue is closed or implementation and validation evidence proves the bug no longer exists, drops stale plans and legacy task files from completed feature or architecture goals, and deletes obsolete feature or architecture docs.

ThinkInAIXYZ/deepchat
Works withGitHub
See how to install

Good for

  • Remove issue documents after confirming a bug is resolved
  • Clear old plans from completed feature work
  • Update or remove architecture documents after replacement
  • Check documentation references after cleanup

Files included (2)

  • SKILL.md3.1 KB
  • agents/openai.yaml252 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

DeepChat SDD Cleanup

Rule

Run this skill only when the developer explicitly asks for SDD cleanup, documentation tidying, pruning, or removal of completed/stale SDD files. Do not run it as an automatic final step of ordinary feature, bug, architecture, or release work.

Workflow

  1. Inspect docs/spec-driven-dev.md, docs/README.md, and git status.
  2. Inventory docs/features, docs/issues, and docs/architecture with find or rg.
  3. Prefer parallel sub-agent review when available:
    • one pass for docs/features
    • one pass for docs/issues
    • one pass for docs/architecture
    • optional verifier pass over proposed deletes
  4. Apply only changes with clear evidence. Keep a concise keep/delete/update list for handoff.
  5. Validate references after edits.

Cleanup Rules

  • Completed feature or architecture goal: delete plan.md and any legacy tasks.md; keep spec.md only when it still defines a maintained contract, regression guard, platform policy, or architecture decision.
  • Completed issue goal: delete the issue folder when a linked GitHub issue is closed or the implementation and validation evidence prove the bug no longer exists.
  • Removed feature: delete its folder when the product/code path is gone and the spec has no reusable decision record.
  • Obsolete architecture: delete its folder when the module was fully replaced and the doc no longer describes a maintained boundary; otherwise update the spec.
  • Historical feature spec affected by an architecture refactor: update the retained spec instead of leaving contradictory docs.

GitHub Checks

Use gh only when it is installed and authenticated. For linked issue docs, verify closure with gh issue view <number> --json state,url,title when possible. If gh is unavailable, do not delete solely because a GitHub link looks old.

Never Delete

  • Active work with unchecked plan.md steps or legacy tasks.
  • Any document containing unresolved [NEEDS CLARIFICATION].
  • A document referenced by docs/README.md, docs/ARCHITECTURE.md, docs/FLOWS.md, or AGENTS instructions unless the reference is updated in the same change.
  • Runtime baselines or machine-read files unless the cleanup request explicitly covers them.

Validation

  • Run rg -n "plan.md|tasks.md|docs/archives|NEEDS CLARIFICATION" docs AGENTS.md .agents/skills and inspect any stale policy references.
  • Run git status --short.
  • For Markdown-only cleanup, formatting/lint commands are optional unless repository instructions or touched generated files require them.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

add-provider

FreeSummary

Add an LLM provider to DeepChat by choosing a suitable API connection method, updating authentication and model configuration, and making focused source changes with tests for the affected behavior.

  • Adding an OpenAI-compatible provider
  • Connecting a provider through an existing transport
  • Implementing provider-specific authentication
ThinkInAIXYZ/deepchat6.4KUpdated Oct 13, 2026

algorithmic-art

FreeSummary

Create original generative art with p5.js, using code to produce patterns and motion. Receive a written artistic concept and an interactive HTML viewer with adjustable parameters, reproducible random variations, seed navigation, and PNG downloads.

  • Create art from particle motion and flow fields
  • Explore patterns by adjusting sliders
  • Reproduce a favorite variation with the same seed
ThinkInAIXYZ/deepchat6.4KUpdated Oct 13, 2026

code-review

FreeSummary

Review code for readability, maintainability, security, and performance. Receive an overview, issues grouped by severity, concrete improvements with code examples, and positive feedback on parts of the implementation that work well.

  • Reviewing an implementation before sharing it
  • Checking code for security weaknesses
  • Finding performance improvement opportunities
ThinkInAIXYZ/deepchat6.4KUpdated Oct 13, 2026

computer-use

FreeSummary

Operate desktop applications through DeepChat's built-in Computer Use tools. Inspect windows, click controls, enter text, use menus, and arrange windows, checking the visible result after each action.

  • Entering text and using controls in desktop apps
  • Opening files or URLs in an application
  • Arranging application windows
ThinkInAIXYZ/deepchat6.4KUpdated Oct 13, 2026

deepchat-cli

FreeSummary

Use DeepChat's bundled command-line interface to compare models, generate media, transcribe audio, and extract text from images. Also inspect runtime status, artifact metadata, public settings, installed Skills, and MCP connections to external tools.

  • Comparing models and collecting benchmark results
  • Generating images, video, or speech
  • Transcribing audio and extracting text from images
ThinkInAIXYZ/deepchat6.4KUpdated Oct 13, 2026

deepchat-data-import

FreeSummary

Build third-party tools to inspect, extract, migrate, or analyze DeepChat's local settings and conversations. Work through data locations, database encryption, and table relationships while favoring read-only copies and redacted output.

  • Building an importer for another application
  • Inspecting provider, model, and MCP settings
  • Extracting conversations for analysis
ThinkInAIXYZ/deepchat6.4KUpdated Oct 13, 2026

See all skills by ThinkInAIXYZ

Report a problem with this skill