Bitrix Best Practice
Router skills with operational coding rules for 1C-Bitrix and Bitrix24: controllers, ORM, cache, routing
Low risk
We rate an entry low when it mostly gives the agent instructions and reference material.
Why this level
- Reference coding rules only; it performs no actions on a portal or server
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/bitrix-best-practiceDetects the agents on your machine, checks the risk and pins the version.
Other ways to install
Run in a terminal in the project folder
npx skills add bitrix-tools/best-practice --skill bitrix-best-practice-core -a claude-code -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit c2783e7
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix-tools/best-practice.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix-best-practice-core/
git -C "$tmp" checkout c2783e74d12312794f19d53332e913176e15670f
mkdir -p .claude/skills
cp -R "$tmp/skills/bitrix-best-practice-core" .claude/skills/bitrix-best-practice-coreCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add bitrix-tools/best-practice --skill bitrix-best-practice-core -a cursor -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit c2783e7
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix-tools/best-practice.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix-best-practice-core/
git -C "$tmp" checkout c2783e74d12312794f19d53332e913176e15670f
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix-best-practice-core" .agents/skills/bitrix-best-practice-coreCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add bitrix-tools/best-practice --skill bitrix-best-practice-core -a github-copilot -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit c2783e7
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix-tools/best-practice.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix-best-practice-core/
git -C "$tmp" checkout c2783e74d12312794f19d53332e913176e15670f
mkdir -p .github/skills
cp -R "$tmp/skills/bitrix-best-practice-core" .github/skills/bitrix-best-practice-coreCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add bitrix-tools/best-practice --skill bitrix-best-practice-core -a codex -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit c2783e7
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix-tools/best-practice.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix-best-practice-core/
git -C "$tmp" checkout c2783e74d12312794f19d53332e913176e15670f
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix-best-practice-core" .agents/skills/bitrix-best-practice-coreCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add bitrix-tools/best-practice --skill bitrix-best-practice-core -a gemini-cli -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit c2783e7
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix-tools/best-practice.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix-best-practice-core/
git -C "$tmp" checkout c2783e74d12312794f19d53332e913176e15670f
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix-best-practice-core" .agents/skills/bitrix-best-practice-coreCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix-tools/best-practice.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix-best-practice-core/
git -C "$tmp" checkout c2783e74d12312794f19d53332e913176e15670f
mkdir -p .devin/skills
cp -R "$tmp/skills/bitrix-best-practice-core" .devin/skills/bitrix-best-practice-coreCommands for macOS and Linux, on Windows run them in Git Bash.
Formerly Windsurf.
Run in a terminal in the project folder
npx skills add bitrix-tools/best-practice --skill bitrix-best-practice-core -a cline -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit c2783e7
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix-tools/best-practice.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix-best-practice-core/
git -C "$tmp" checkout c2783e74d12312794f19d53332e913176e15670f
mkdir -p .cline/skills
cp -R "$tmp/skills/bitrix-best-practice-core" .cline/skills/bitrix-best-practice-coreCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add bitrix-tools/best-practice --skill bitrix-best-practice-core -a roo -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit c2783e7
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix-tools/best-practice.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix-best-practice-core/
git -C "$tmp" checkout c2783e74d12312794f19d53332e913176e15670f
mkdir -p .roo/skills
cp -R "$tmp/skills/bitrix-best-practice-core" .roo/skills/bitrix-best-practice-coreCommands for macOS and Linux, on Windows run them in Git Bash.
A fork of Roo Code, same .roo folders.
Run in a terminal in the project folder
npx skills add bitrix-tools/best-practice --skill bitrix-best-practice-core -a opencode -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit c2783e7
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix-tools/best-practice.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix-best-practice-core/
git -C "$tmp" checkout c2783e74d12312794f19d53332e913176e15670f
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix-best-practice-core" .agents/skills/bitrix-best-practice-coreCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix-tools/best-practice.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix-best-practice-core/
git -C "$tmp" checkout c2783e74d12312794f19d53332e913176e15670f
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix-best-practice-core" .agents/skills/bitrix-best-practice-coreCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix-tools/best-practice.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix-best-practice-core/
git -C "$tmp" checkout c2783e74d12312794f19d53332e913176e15670f
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix-best-practice-core" .agents/skills/bitrix-best-practice-coreCommands for macOS and Linux, on Windows run them in Git Bash.
Run npx skills add bitrix-tools/best-practice to install both skills, or npx skills add bitrix-tools/best-practice --skill bitrix-best-practice-core for just one.
Other ways from the author
npx skills add bitrix-tools/best-practiceInstalls both skills at once via the skills orchestration library.
This is third-party code. Review the repository files before installing.
What it does
The project gives two router skills for agents: bitrix-best-practice-core, covering core product entities (controllers, routing, configuration, cache, logger, JWT, validation and more), and bitrix-best-practice-sql, covering Bitrix's database layer and ORM (DataManager, Objectify, query building, ORM writes). Each skill does not hold the rules itself but helps the agent figure out which specific rule file under rules/ to open for the task, saving context. This is not official Bitrix documentation but operational rules: how to write, review and make decisions in code, written as plain Markdown rule files.
Who it is for. For 1C-Bitrix and Bitrix24 developers who want the agent to write and review code against a consistent set of team rules.
Good fit when
- You want consistent rules for controllers, cache, ORM and routing across the whole Bitrix team
- You want the agent to open only the relevant rule file for a task instead of loading everything at once
- You have your own process for extending rules and want a ready template for adding a new rule file
Not a fit when
- You need official product documentation, not a team's operational rules: see docs.1c-bitrix.ru or apidocs.bitrix24.ru
- You are not developing on 1C-Bitrix or Bitrix24
- You need full ready-made code examples, not short topic rules
Example request
Check this controller and database query against the Bitrix best practices from this skillLimitations
This is not official Bitrix documentation but one team's opinions and rules, and some choices may not match your own conventions. The rules are mostly for PHP development on the platform; other stack languages are not covered. A separate helper skill, add-rule-to-best-practice, exists for extending the set with your own rules.
How to disable. Delete the skills/bitrix-best-practice-core and skills/bitrix-best-practice-sql folders from your agent install.
Security check
- Reference coding rules only; it performs no actions on a portal or server
README in short
The short Russian README explains that each skill acts as a router to rule files rather than one monolithic document, and explicitly notes this is not official Bitrix documentation, linking to docs.1c-bitrix.ru and apidocs.bitrix24.ru. It shows three install paths: asking the agent directly, npx skills add for all skills at once, and with --skill for a specific one.
FAQ
How do I add my own rule?
There is a helper skill at .ai/skills/add-rule-to-best-practice with simple and complex rule-file examples and a template for registering it in the router skill.
Can I install just one skill?
Yes, npx skills add supports a --skill flag with the exact skill name: bitrix-best-practice-core or bitrix-best-practice-sql.
Related
A skills library that gives coding agents a development process: brainstorming, planning, TDD, subagents and code review
Skills for real engineers by Matt Pocock
Skills For Real Engineers
Small composable skills for engineering with agents: plan grilling, TDD, bug diagnosis, code review and architecture
GitHub toolkit for spec-driven development: the specify CLI adds agent commands and skills to a project, from principles to implementation
Reference MCP servers
Model Context Protocol servers
Official reference MCP servers: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time and Everything