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

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

Скилл для Claude Code и Cursor задаёт свод инженерных принципов для проектирования, отладки и проверки кода. Агент подключает его при выборе типов, разборе диффа или когда пользователь пишет /ds-principles.

MIT 557 установок ★ 320 обновлён 2026-10-28

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

Что делает ds-principles

Скилл организует работу агента через тридцать три конкретных правила, которые охватывают структуру данных, изоляцию состояний и поиск корневых причин ошибок. Правила требуют удалять мёртвый код до правок, валидировать входные данные на границах систем и тестировать поведение, а не внутреннюю реализацию.

Каждый триггер активирует соответствующий норматив прямо во время генерации тестов или рефакторинга. Скилл запрещает использовать any и неявные приведения типов без проверки.

Команду /ds-principles вызывают в чате, чтобы задействовать инженерный стек в текущей сессии.

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

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

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

  • Примени ds-principles при проектировании этой схемы данных
  • Проверь текущий дифф по правилам ds-principles
  • Вызови /ds-principles для отладки этой ошибки

Как установить ds-principles

1Через Skills CLI (Vercel)

npx skills add aicodeking/deepseek-stack --skill ds-principles -a claude-code

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

~/.claude/skills/ds-principles/SKILL.md

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

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

Вопросы о ds-principles

Как установить ds-principles в Claude Code?

Выполните команду npx skills add aicodeking/deepseek-stack --skill ds-principles -a claude-code, а затем проверьте файл ~/.claude/skills/ds-principles/SKILL.md.

Что делает ds-principles?

Задаёт строгие инженерные принципы для архитектуры, отладки и проверки кода, которые агент применяет по триггерам или команде.

Какие требования предъявляет скилл?

Скилл не требует внешних ключей или библиотек и работает внутри поддерживаемых сред разработки.

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

SKILL.md · MIT
---
name: ds-principles
description: "Compact engineering principles for design, debugging, verification, and delegation, each with a trigger. Use when choosing structure or types, sizing a diff, debugging, writing tests, or when the user types /ds-principles."
---

# Engineering principles

If a trigger matches, apply the rule. Name principles that changed a decision.

## Design

1. **Subtract, then add little.** Remove dead code and stale checks first, then make the shortest diff that works. No abstraction with one user. Apply when sizing a diff or tempted to add a layer.
2. **Data shape first.** Choose the core types and structures before logic. Apply before writing new logic.
3. **Model the domain.** Put states in one structure, such as a typed union, state machine, or lookup table, not scattered conditionals. Apply when code branches a lot or repeats a shape across files.
4. **Redesign for the new need.** Fit a new requirement as if it existed from day one. Apply when an addition strains the design.
5. **Low reader load.** Inline one-caller wrappers and shrink mutable scope. Apply when code is hard to trace.
6. **Guards at boundaries.** Validate where input enters: CLI, config, network, files, external APIs. Trust types inside and keep core logic pure. Apply when adding validation or error handling.
7. **Idempotent steps.** Rerunning a step, even after a crash, reaches the same state. Apply to commands, setup, and retries.
8. **No shared writers.** Give each concurrent actor its own file, branch, or key before using locks. Apply when parallel work touches shared state.
9. **Migrate, then delete.** Move every caller and delete the old API in one change. No shims. Apply when replacing an API or rewriting in phases.
10. **Compare options.** For an unprecedented design, sketch two or three. Prefer fewer, polished features. Apply to novel architecture, UX, or scope choices.

## Debugging and verification

11. **Fix root causes.** Fix where state first went wrong. A guard fixes only legitimate states. Apply when debugging.
12. **Attack the premise.** After two failed fixes that share an assumption, write it down and test it directly. Apply before a third attempt.
13. **Prove it works.** Run the real thing and read the actual output, not a proxy. Apply before claiming done.
14. **Verifiable units.** Split work into steps that each end in a passing check. Apply to sweeps, migrations, and stacked commits.
15. **Test behavior.** Assert what callers can observe, so tests survive refactors. Apply when writing or keeping a test.
16. **Explain the number.** Find what limits a measurement and confirm it measured the right work. Apply to benchmarks and eval scores.
17. **Build the tool.** Script bulk or repeated work so it can be rerun. Apply to large edit sets or checks.

## Process

18. **Guard the context.** Keep summaries, not dumps. Send bulk reading to subagents. Apply when outputs or files are large.
19. **Do not block on the human.** On reversible work, proceed and show the result. Apply when tempted to ask "should I?".
20. **Encode repeated lessons.** A correction given twice becomes a lint, test, or script. Apply when a mistake recurs.
21. **Comments explain why.** Keep a comment only for a reason the code cannot show, such as an external constraint or a public API contract. Delete narration and dead code. Fix code whose surprise needs a comment. Apply when writing or reviewing code.

## Types

- Make illegal states unrepresentable. Use discriminated unions, not optional-field bags.
- Parse external data once at the boundary into a named type. Trust it inside.
- Use `unknown` for untrusted input. Never `any`. No `as` casts before validation.
- Derive types from a schema, not hand-written guards.
- Add a `never` check in default branches so new variants fail the build.
- Brand primitives that must not mix, such as user IDs and order IDs.

© aicodeking · MIT · aicodeking/deepseek-stack

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
solid-principles TheBushidoCollective Скилл solid-principles для Claude Code помогает применять SOLID при проектировании модулей, функций и компонентов. Агент подключает его во время реализации архитектуры кода. CX Codex +1 611установок principle-redesign-from-first-principles backnotprop Скилл principle-redesign-from-first-principles для Claude Code и Codex: перестраивает дизайн под новое требование так, будто оно было с самого начала. Затрагивает несколько файлов и связей. CX Codex +1 10 200установок clean-code-principles AsyrafHussin Скилл clean-code-principles для ревью архитектуры и качества кода: SOLID, DRY, KISS, паттерны проектирования. Пригодится при рефакторинге и обсуждении решений по дизайну. CX Codex +1 1 900установок software-design-principles databricks-solutions Скилл software-design-principles для Claude Code задаёт правила архитектурного ревью, планирования рефакторинга и проверки зависимостей. Помогает согласовать слои и зоны ответственности перед слиянием PR. CX Codex +1 ★ 38звёзд репо thinking-first-principles tjboudreaux Скилл thinking-first-principles для Claude Code отделяет реальные ограничения от привычек и перестраивает решение с нуля. Запускается, если задачу останавливает «так не делается» без доказательств. CX Codex +1 844установок dotnet-solid-principles wshaddix Скилл dotnet-solid-principles для Claude Code, помогающий применять принципы SOLID, DRY и SRP в проектах на .NET. Автоматически находит антипаттерны в C# и предлагает варианты рефакторинга классов. CX Codex +1 112установок

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

Весь набор →
ds-plan-loop Скилл ds-plan-loop для Claude Code составляет план с проверкой каждого шага, пересматривает его и выполняет задачу поэтапно. Запускается для работы с несколькими файлами, неясным объёмом или после пропущенных шагов. CX Codex +1 569установок ds-mode Задаёт рабочий порядок для задач по программированию: сначала разобраться в коде, затем вносить проверяемые изменения. Включается в начале задачи, по запросу /ds-mode или когда работа отклоняется от плана. CX Codex +1 567установок ds-unstick Скилл ds-unstick для Claude Code останавливает циклы неудачных правок и проверяет скрытые допущения в коде. Включается, когда одна и та же ошибка повторяется после двух неудачных попыток починки. CX Codex +1 566установок ds-context-reset Скилл ds-context-reset для Claude Code управляет сбросом контекста длинных задач через файл PROGRESS.md. CX Codex +1 562установок ds-blast-radius Скилл ds-blast-radius для Claude Code ищет, что может сломаться за пределами diff, и проверяет ключевой факт запуском кода. Запускается перед выпуском рискованных или непроверенных изменений. CX Codex +1 550установок ds-help Скилл ds-help для Claude Code подбирает нужный инструмент под задачу и объясняет структуру набора deepseek-stack. CX Codex +1 549установок ds-design-audit Скилл ds-design-audit для Claude Code или Codex оценивает интерфейс экрана по визуальным критериям и коду, исправляет главные дефекты и проверяет результат перед релизом или при шаблонном виде страницы. CX Codex +1 548установок ds-design Скилл ds-design для Claude Code задаёт визуальное направление интерфейсу и помогает уйти от шаблонного вида. Запускается при создании страницы, экрана или компонента, а также при переработке готового интерфейса. CX Codex +1 548установок

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

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