К основному содержанию
скилл CX Codex

modular-code — скилл для Claude Code: что делает и как установить

Скилл modular-code для Claude Code делит крупные Python-файлы на модули по смыслу и слоям. Разделяет файлы со смешанными задачами и кодом, который трудно читать и тестировать.

MIT ★ 3 951 обновлён 2026-01-26

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add parcadei/Continuous-Claude-v3 --skill modular-code -a claude-code
Открыть на GitHub

Что делает modular-code

Скилл предлагает ориентиры по размеру файлов: 150–500 строк — рабочий диапазон, а файлы свыше 500 строк советует проверять на естественные места для разделения. Разбивать код только ради числа строк не стоит: модули можно выделять по предметной области, уровню абстракции, типам данных или операциям ввода-вывода.

Рекомендации охватывают структуру пакета, имена модулей и перенос функций из большого файла. При рефакторинге предлагается переносить связанные функции поэтапно, обновлять импорты и запускать тесты после каждого переноса. Для файлов на 2000 строк и больше в скилле указана необходимость разделения, но некоторые вычислительные модули могут быть исключением.

Какие задачи решает

  • разделить файл с несвязанными задачами на модули
  • выделить операции ввода-вывода из основной логики
  • организовать функции по предметной области
  • перенести части большого файла и обновить импорты
  • подготовить структуру Python-пакета с моделями и обработчиками

Примеры запросов агенту

  • Раздели этот Python-файл на модули по связанным задачам, сохранив понятные имена.
  • Предложи структуру пакета для этого кода и отдели ввод-вывод от основной логики.
  • Переноси функции из большого файла по группам, обновляй импорты и запускай тесты после каждого шага.

Как установить modular-code

1Через Skills CLI (Vercel)

npx skills add parcadei/Continuous-Claude-v3 --skill modular-code -a claude-code

2Вручную: положить файлы

~/.claude/skills/modular-code/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/modular-code/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о modular-code

Как установить modular-code в Claude Code?

Выполните npx skills add parcadei/Continuous-Claude-v3 --skill modular-code -a claude-code. Файл скилла находится по пути ~/.claude/skills/modular-code/SKILL.md.

Что делает modular-code?

Скилл помогает организовать Python-код в модули с понятными границами и именами. Он также описывает поэтапный перенос функций из крупных файлов.

Когда modular-code советует разделять файл?

Среди ориентиров — размер свыше 500 строк, несвязанные задачи в одном файле и сложности с поиском функций или организацией тестов. Одного числа строк недостаточно: разделение должно следовать смысловым границам.

Исходный текст

SKILL.md · MIT
---
name: modular-code
description: Modular Code Organization
user-invocable: false
---

# Modular Code Organization

Write modular Python code with files sized for maintainability and AI-assisted development.

## File Size Guidelines

| Lines | Status | Action |
|-------|--------|--------|
| 150-500 | Optimal | Sweet spot for AI code editors and human comprehension |
| 500-1000 | Large | Look for natural split points |
| 1000-2000 | Too large | Refactor into focused modules |
| 2000+ | Critical | Must split - causes tooling issues and cognitive overload |

## When to Split

Split when ANY of these apply:
- File exceeds 500 lines
- Multiple unrelated concerns in same file
- Scroll fatigue finding functions
- Tests for the file are hard to organize
- AI tools truncate or miss context

## How to Split

### Natural Split Points

1. **By domain concept**: `auth.py` → `auth/login.py`, `auth/tokens.py`, `auth/permissions.py`
2. **By abstraction layer**: Separate interface from implementation
3. **By data type**: Group operations on related data structures
4. **By I/O boundary**: Isolate database, API, file operations

### Package Structure

```
feature/
├── __init__.py      # Keep minimal, just exports
├── core.py          # Main logic (under 500 lines)
├── models.py        # Data structures
├── handlers.py      # I/O and side effects
└── utils.py         # Pure helper functions
```

## DO

- Use meaningful module names (`data_storage.py` not `utils2.py`)
- Keep `__init__.py` files minimal or empty
- Group related functions together
- Isolate pure functions from side effects
- Use snake_case for module names

## DON'T

- Split files arbitrarily by line count alone
- Create single-function modules
- Over-modularize into "package hell"
- Use dots or special characters in module names
- Hide dependencies with "magic" imports

## Refactoring Large Files

When splitting an existing large file:

1. **Identify clusters**: Find groups of related functions
2. **Extract incrementally**: Move one cluster at a time
3. **Update imports**: Fix all import statements
4. **Run tests**: Verify nothing broke after each move
5. **Document**: Update any references to old locations

## Current Codebase Candidates

Files over 2000 lines that need attention:
- Math compute modules (scipy, mpmath, numpy) - domain-specific, may be acceptable
- patterns.py - consider splitting by pattern type
- memory_backfill.py - consider splitting by operation type

## Sources

- [The Hitchhiker's Guide to Python](https://docs.python-guide.org/writing/structure/)
- [Python Project Best Practices - Dagster](https://dagster.io/blog/python-project-best-practices)
- [Right-Sizing Python Files for AI Editors](https://medium.com/@eamonn.faherty_58176/right-sizing-your-python-files-the-150-500-line-sweet-spot-for-ai-code-editors-340d550dcea4)
- [PEP 8 Style Guide](https://peps.python.org/pep-0008/)

© parcadei · MIT · parcadei/Continuous-Claude-v3

Похожие скиллы

Все скиллы по теме «Код-ревью и рефакторинг» →
refactor boshu2 Скилл refactor для Claude Code реорганизует код без изменения логики с проверкой тестами до и после правок. Включается по запросу на очистку, дедупликацию или вынесение функции. CX Codex +1 123установок modular-decomposition tech-leads-club Скилл modular-decomposition проводит монолит через пять шагов анализа перед разбивкой на модули: размер и инвентаризация компонентов, дублирование логики, иерархия, связность, группировка по доменам. CX Codex +1 ★ 7 191звёзд репо modular-design-principles tech-leads-club Скилл modular-design-principles даёт правила модульной архитектуры и изолированных контекстов без привязки к стеку. Помогает спроектировать границы модулей и найти неявную связность. CX Codex +1 ★ 7 191звёзд репо go-packages cxuu Скилл go-packages задаёт правила разбиения Go-кода на пакеты, структурирует импорты и запрещает пакеты util. Пригодится на старте проекта или при рефакторинге растущей кодовой базы. CX Codex +1 1 300установок python pproenca С набором правил оптимизации производительности Python 3.11+. Срабатывает при работе с asyncio, структурами данных, управлением памятью, циклами и строками. CX Codex +1 329установок konsistent-config vercel-labs Скилл konsistent-config для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode создаёт и редактирует konsistent.json — конфиг структурных проверок TypeScript-кодовой базы. CX Codex +1 2 600установок

Из того же набора161

Весь набор →
rudin-real-complex-analysis Скилл rudin-real-complex-analysis помогает решать задачи и проверять доказательства по учебнику Walter Rudin «Real and Complex Analysis» с помощью дерева теорем и Python-скриптов. CX Codex +1 ★ 3 951звёзд репо agent-context-isolation Скилл agent-context-isolation для Claude Code учит передавать работу фоновых агентов через файлы. Он помогает не загружать их полные транскрипты в основной контекст. CX Codex +1 ★ 3 951звёзд репо fields Скилл fields для работы с полями в абстрактной алгебре. Помогает проверить аксиомы поля, вычислить минимальные многочлены и решить алгебраические уравнения через встроенные инструменты Bash и Read. CX Codex +1 ★ 3 951звёзд репо opc-architecture Скилл opc-architecture объясняет Claude Code архитектуру Orchestrated Parallel Claude: работу хуков, запуск дочерних процессов и координацию агентов через PostgreSQL. CX Codex +1 ★ 3 951звёзд репо compactness Скилл compactness для решения задач на компактность в топологии. Помогает проверить, компактно ли пространство, и применить теоремы Хайне-Бореля, Тихонова и следствия компактности. CX Codex +1 ★ 3 951звёзд репо source-coding Скилл source-coding для Claude Code решает задачи теории информации: оптимальное кодирование, энтропия Шеннона, коды Хаффмана и сжатие данных. CX Codex +1 ★ 3 951звёзд репо sigma-algebras Скилл sigma-algebras для Claude Code решает задачи по теории меры: проверяет аксиомы и измеримость, генерирует сигма-алгебры и строит их произведения. CX Codex +1 ★ 3 951звёзд репо validate-agent Субагент validate-agent проверяет технические решения в плане против текущих best practices и прошлого опыта. Запускается перед реализацией, чтобы поймать устаревшие подходы и риски. CX Codex ★ 3 951звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой