CommunityProductivité et collaborationgithub.com

softaworks/agent-md-refactor

Refactorise les fichiers d'instructions d'agent (AGENTS.md, CLAUDE.md, etc.) volumineux en suivant les principes de divulgation progressive. Divise les fichiers monolithiques en une documentation organisée et liée.

Qu'est-ce que agent-md-refactor ?

Ce skill, `softaworks/agent-md-refactor`, permet de refactoriser et d'organiser les fichiers d'instructions d'agent IA (comme AGENTS.md, CLAUDE.md, etc.) qui sont devenus trop longs et difficiles à gérer. En appliquant le principe de divulgation progressive, il divise un fichier monolithique en plusieurs fichiers plus petits, chacun traitant d'un aspect spécifique (ex: règles générales, workflows, outils). Les fichiers sont ensuite liés entre eux via des références, ce qui permet à l'agent de naviguer plus facilement et de ne charger que les informations nécessaires. Ce skill est particulièrement utile pour les développeurs utilisant des assistants IA dans leurs IDE (comme Cursor, Claude Code, etc.) qui souhaitent maintenir une documentation claire, maintenable et efficace pour leurs projets. Il améliore la lisibilité, réduit le bruit et optimise les performances de l'agent en lui fournissant une structure modulaire et cohérente.

Compatible avec✓Claude Code~Codex CLI~Cursor
Part ofAgent Workflows
npx skills add https://github.com/softaworks/agent-toolkit/tree/main/skills/agent-md-refactor

Installed? Explore more Productivité et collaboration skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Voir l'original→Voir toutes les compétences

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Documentation

Que fait agent-md-refactor ?

Refactorise les fichiers d'instructions d'agent (AGENTS.md, CLAUDE.md, etc.) volumineux en suivant les principes de divulgation progressive. Divise les fichiers monolithiques en une documentation organisée et liée.

Objectif

Si vos fichiers d'instructions d'agent (AGENTS.md, CLAUDE.md, etc.) sont devenus trop longs et difficiles à gérer, ce skill vous aide à les restructurer en suivant une approche de divulgation progressive. Au lieu d'un seul fichier massif, vous obtenez un ensemble de fichiers plus petits et interconnectés.

Fonctionnalités

  • Détection de contenu volumineux : Analyse les fichiers d'instructions et identifie les sections candidates à l'extraction.
  • Divulgation progressive : Crée une structure de dossiers logique avec un fichier principal qui résume le projet et renvoie vers des fichiers spécialisés.
  • Organisation cohérente : Sépare les règles générales, les workflows, la configuration des outils et les notes de contexte dans des fichiers distincts.
  • Navigation améliorée : Inclut des liens entre les fichiers, permettant à l'agent de naviguer efficacement dans la documentation.
  • Prise en charge de plusieurs formats : Fonctionne avec AGENTS.md, CLAUDE.md, CURSOR.md, ou tout autre fichier d'instructions d'agent.

Utilisation

  1. Identifier le fichier cible : Déterminez le fichier d'instructions à refactoriser (ex: CLAUDE.md, AGENTS.md).
  2. Exécuter le skill : Utilisez softaworks/agent-md-refactor avec le chemin du fichier en tant qu'argument.
  3. Examiner le résultat : Le skill créera un dossier (ex: instructions/) contenant les fichiers refactorisés.
  4. Mettre à jour les références : Assurez-vous que votre agent est configuré pour charger la nouvelle structure (ex: en référençant le dossier ou le fichier principal).

Exemple de sortie

Avant : CLAUDE.md (un seul fichier volumineux)

Après :

instructions/
  README.md        # Résumé du projet, règles principales, index
  general.md       # Règles générales, contraintes, préférences
  workflows.md     # Workflows courants, bonnes pratiques
  tools.md         # Configuration des outils, commandes utiles
  context.md       # Notes de contexte, décisions architecturales

Compatibilité

Ce skill est compatible avec les agents fonctionnant avec des fichiers d'instructions markdown, notamment :

  • Claude Code (CLAUDE.md)
  • Cursor (CURSOR.md, .cursorrules)
  • Codex CLI (AGENTS.md)
  • Windsurf (AGENTS.md)
  • Tout autre agent utilisant un format markdown similaire

Notes

  • Conservez une sauvegarde de votre fichier original avant la refactorisation.
  • Le skill ne modifie pas le fichier original ; il crée une nouvelle structure.
  • Vérifiez que les liens dans les fichiers générés sont corrects avant de les utiliser en production.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

softaworks/c4-architecture

Generate architecture documentation using C4 model Mermaid diagrams. Use when asked to create architecture diagrams, document system architecture, visualize software structure, create C4 diagrams, or generate context/container/component/deployment diagrams. Triggers include "architecture diagram", "C4 diagram", "system context", "container diagram", "component diagram", "deployment diagram", "document architecture", "visualize architecture".

softaworks/codex

Use when the user asks to run Codex CLI (codex exec, codex resume) or references OpenAI Codex for code analysis, refactoring, or automated editing. Uses GPT-5.2 by default for state-of-the-art software engineering.

softaworks/command-creator

This skill should be used when creating a Claude Code slash command. Use when users ask to "create a command", "make a slash command", "add a command", or want to document a workflow as a reusable command. Essential for creating optimized, agent-executable slash commands with proper structure and best practices.

softaworks/commit-work

Create high-quality git commits: review/stage intended changes, split into logical commits, and write clear commit messages (including Conventional Commits). Use when the user asks to commit, craft a commit message, stage changes, or split work into multiple commits.

softaworks/crafting-effective-readmes

Use when writing or improving README files. Not all READMEs are the same — provides templates and guidance matched to your audience and project type.

softaworks/daily-meeting-update

Interactive daily standup/meeting update generator. Use when user says 'daily', 'standup', 'scrum update', 'status update', 'what did I do yesterday', 'prepare for meeting', 'morning update', or 'team sync'. Pulls activity from GitHub, Jira, and Claude Code session history. Conducts 4-question interview (yesterday, today, blockers, discussion topics) and generates formatted Markdown update.

softaworks/database-schema-designer

Design robust, scalable database schemas for SQL and NoSQL databases. Provides normalization guidelines, indexing strategies, migration patterns, constraint design, and performance optimization. Ensures data integrity, query performance, and maintainable data models.

softaworks/dependency-updater

Smart dependency management for any language. Auto-detects project type, applies safe updates automatically, prompts for major versions, diagnoses and fixes dependency issues.

softaworks/difficult-workplace-conversations

Structured approach to workplace conflicts, performance discussions, and challenging feedback using preparation-delivery-followup framework. Use when preparing for tough conversations, addressing conflicts, giving critical feedback, or navigating sensitive workplace discussions.

softaworks/domain-name-brainstormer

Generates creative domain name ideas for your project and checks availability across multiple TLDs (.com, .io, .dev, .ai, etc.). Saves hours of brainstorming and manual checking.

softaworks/feedback-mastery

Navigate difficult conversations and deliver constructive feedback using structured frameworks. Covers the Preparation-Delivery-Follow-up model and Situation-Behavior-Impact (SBI) feedback technique. Use when preparing for difficult conversations, giving feedback, or managing conflicts.

softaworks/game-changing-features

Find 10x product opportunities and high-leverage improvements. Use when user wants strategic product thinking, mentions '10x', wants to find high-impact features, or says 'what would make this 10x better', 'product strategy', or 'what should we build next'.

softaworks/gemini

Use when the user asks to run Gemini CLI for code review, plan review, or big context (>200k) processing. Ideal for comprehensive analysis requiring large context windows. Uses Gemini 3 Pro by default for state-of-the-art reasoning and coding.

softaworks/gepetto

Creates detailed, sectionized implementation plans through research, stakeholder interviews, and multi-LLM review. Use when planning features that need thorough pre-implementation analysis.

softaworks/humanizer

Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases. Credits: Original skill by @blader - https://github.com/blader/humanizer

softaworks/lesson-learned

Analyze recent code changes via git history and extract software engineering lessons. Use when the user asks 'what is the lesson here?', 'what can I learn from this?', 'engineering takeaway', 'what did I just learn?', 'reflect on this code', or wants to extract principles from recent work.

softaworks/marp-slide

Create professional Marp presentation slides with 7 beautiful themes (default, minimal, colorful, dark, gradient, tech, business). Use when users request slide creation, presentations, or Marp documents. Supports custom themes, image layouts, and "make it look good" requests with automatic quality improvements.

softaworks/meme-factory

Generate memes using the memegen.link API. Use when users request memes, want to add humor to content, or need visual aids for social media. Supports 100+ popular templates with custom text and styling.

softaworks/mermaid-diagrams

Comprehensive guide for creating software diagrams using Mermaid syntax. Use when users need to create, visualize, or document software through diagrams including class diagrams (domain modeling, object-oriented design), sequence diagrams (application flows, API interactions, code execution), flowcharts (processes, algorithms, user journeys), entity relationship diagrams (database schemas), C4 architecture diagrams (system context, containers, components), state diagrams, git graphs, pie charts, gantt charts, or any other diagram type. Triggers include requests to "diagram", "visualize", "model", "map out", "show the flow", or when explaining system architecture, database design, code structure, or user/application flows.

softaworks/naming-analyzer

Suggest better variable, function, and class names based on context and conventions.

Skills associés

steipete/gemini

Gemini CLI one-shot prompts, summaries, generation, skills, hooks, MCP, or Gemma routing.

community

steipete/gh-issues

Fetch GitHub issues, select candidates, spawn background fix agents, open PRs, and optionally process PR review comments.

community

steipete/skill-creator

Create, edit, audit, tidy, validate, or restructure AgentSkills and SKILL.md files.

community

steipete/clawhub

Search, install, update, sync, or publish agent skills with the ClawHub CLI and registry.

community

steipete/coding-agent

Delegate coding work to Codex, Claude Code, or OpenCode as background workers; not simple edits or read-only code lookup.

community

steipete/mcporter

List, configure, authenticate, call, and inspect MCP servers/tools with mcporter over HTTP or stdio.

community
← More Productivité et collaboration skills