framework_eng/skills/framework-meta/skill-editing-from-project/SKILL.md
Use for editing framework skills while in a 1С project directory (not in the framework repository). Helps find the RU source through symlinks and `.install-session.json` without switching repositories.
npx skillsauth add steelmorgan/1c-agent-based-dev-framework skill-editing-from-projectInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Skills are connected through symlinks to framework_eng/ (EN mirror). Changes are made in framework/ (RU source). The mapping is in .install-session.json.
| Trigger | Action |
|---------|----------|
| The user asks to change a framework skill/rule from the project directory | Follow the procedure below |
| A skill bug needs to be fixed, but the working directory is the 1С project | Open .install-session.json, find the RU path, make the change, synchronize |
Read the .install-session.json file at the project root.
Key fields:
| Field | Purpose |
|------|-----------|
| sync_script | Absolute path to the RU→EN synchronization script |
| framework_dir | Absolute path to framework/ (RU source) |
| component_map | Map of all installed components |
Each component_map item:
{
"skill/vanessa-authoring": {
"type": "skill",
"ru_path": "/path/to/fw/framework/skills/tool-usage/vanessa/vanessa-authoring/SKILL.md",
"en_path": "/path/to/fw/framework_eng/skills/tool-usage/vanessa/vanessa-authoring/SKILL.md"
}
}
Use component_map to find the component by name (the key is type/name).
The ru_path value is the file that needs to be edited.
Open the file at the path from ru_path and make the changes.
Required rules:
en_path — the file will be overwritten during synchronization.Immediately after the changes, run the sync script — do not wait until commit.
# Путь к скрипту — из поля sync_script в .install-session.json
python3 <sync_script> <ru_path>
If multiple files were changed:
python3 <sync_script> --all
| Error | Consequence |
|--------|------------|
| Editing en_path directly | Changes will be lost during synchronization |
| Writing text in English | Violates the language policy |
| Forgetting to synchronize | The EN version becomes outdated, and agents work with an outdated skill |
testing
MUST use BEFORE making a judgment about the cause of a conflict, a test failure, or an artifact dispute. Defines the end-to-end verification method L1→L6 and the classification of the first broken link.
development
MUST use AFTER a work cycle with ≥2 iterations (wrote → error → fixed → success). Provides the retrospective procedure and the format for recording practice/anti-patterns in references/learned-patterns.md or {project}/.context/learned-patterns.md.
tools
MUST use WHEN you are writing reusable knowledge into RLM (pattern / architectural decision / stable domain fact) OR reading it before a non-trivial task/solution in the domain. Provides the breakdown of native-push vs RLM-pull, tools for writing and reading RLM, H-MEM levels, and hygiene.
testing
MUST use WHEN the task is classified as simple (< 20 lines, 1 file, no new metadata objects, no architectural decisions). Provides a short cycle of 3 steps with a guard on the self path and mandatory verify.