use-facet-crates — скилл для Claude Code: установка
Скилл use-facet-crates подсказывает, когда выбирать crates из экосистемы facet вместо serde и чем заменить JSON, TOML, YAML и CLI-парсинг.
Apache-2.0 1 установок ★ 2 590 обновлён 2026-10-26
npx skills add facet-rs/facet --skill use-facet-crates -a claude-codeЧто делает use-facet-crates
Скилл задаёт правила для Rust-кода в workspace facet. Он предлагает использовать facet вместо serde, facet-json вместо serde_json, facet-toml вместо toml, facet-yaml вместо serde_yaml, а figue вместо clap. Для derive используется #[derive(Facet)].
Правила применяются к новому коду и внутренним инструментам, которым не нужна совместимость с serde. Скилл также напоминает проверять Cargo.toml при добавлении зависимостей и ревью кода. В tools/benchmark-analyzer/src/report.rs он указывает на замену serde_json::to_string() для данных графиков.
serde_json здесь допустим, когда внешняя библиотека требует serde, код сравнивает производительность или проверяет совместимость. Если такая зависимость нужна для интеграции, переход на facet может сломать этот контракт.
Какие задачи решает
- выбрать замену serde для нового Rust-кода
- заменить
serde_jsonнаfacet-json - разобрать парсинг TOML через
facet-toml - перейти с
clapнаfigueдля CLI - проверить
Cargo.tomlна зависимости serde
Примеры запросов агенту
- Проверь этот Rust-модуль и замени зависимости serde на подходящие crates из facet.
- Перепиши сериализацию данных графиков в
tools/benchmark-analyzer/src/report.rsсserde_jsonнаfacet-json. - Проверь
Cargo.tomlи объясни, гдеserde_jsonоставлен ради совместимости.
Как установить use-facet-crates
1Через Skills CLI (Vercel)
npx skills add facet-rs/facet --skill use-facet-crates -a claude-code2Вручную: положить файлы
~/.claude/skills/use-facet-crates/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/use-facet-crates/
1Через Skills CLI (Vercel)
npx skills add facet-rs/facet --skill use-facet-crates -a codex2Вручную: положить файлы
.agents/skills/use-facet-crates/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add facet-rs/facet --skill use-facet-crates -a cursor2Вручную: положить файлы
.cursor/skills/use-facet-crates/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install facet-rs/facet .claude/skills/use-facet-crates2Вручную: положить файлы
.github/skills/use-facet-crates/SKILL.md1Через Skills CLI (Vercel)
npx skills add facet-rs/facet --skill use-facet-crates -a gemini-cli2Командой платформы
gemini skills install https://github.com/facet-rs/facet --path .claude/skills/use-facet-cratesВручную: положить файлы
.devin/skills/use-facet-crates/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add facet-rs/facet --skill use-facet-crates -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об use-facet-crates
Как установить use-facet-crates в Claude Code?
Выполните npx skills add facet-rs/facet --skill use-facet-crates -a claude-code, затем проверьте файл ~/.claude/skills/use-facet-crates/SKILL.md.
Что делает use-facet-crates?
Скилл направляет новый Rust-код к crates из экосистемы facet вместо serde-альтернатив. Он также описывает случаи, когда serde_json допустим, и напоминает проверять Cargo.toml.
Когда use-facet-crates разрешает использовать serde_json?
Когда внешняя библиотека требует serde, выполняется сравнение производительности facet и serde или тестируется совместимость с serde. В остальных новых участках workspace предлагается facet-json.
Исходный текст
SKILL.md · Apache-2.0
---
name: use-facet-crates
description: Guidelines for using facet crates (facet-json, facet-toml, figue) instead of serde-based alternatives for consistent dogfooding
---
# Use Facet Crates Instead of Serde Ecosystem
When writing code in this workspace, prefer facet-based crates over serde-based ones. This project is building facet as a replacement for serde, so we should dogfood our own libraries.
## Crate Replacements
| Instead of | Use | Notes |
|--------------------|--------------------|-----------------------------------------|
| `serde` | `facet` | Core derive and traits |
| `serde_json` | `facet-json` | JSON serialization/deserialization |
| `toml` | `facet-toml` | TOML parsing |
| `serde_yaml` | `facet-yaml` | YAML support |
| `clap` | `figue` | CLI argument parsing (separate repo) |
| `serde_derive` | `facet` (derive) | `#[derive(Facet)]` replaces Serialize/Deserialize |
## When to Use Which
### Use facet-json for:
- New code in this workspace
- Internal tools (like benchmark-analyzer)
- Anything that doesn't need serde compatibility
### serde_json is acceptable for:
- Interop with external crates that require serde
- Benchmarks comparing facet vs serde performance
- Code that specifically tests serde compatibility
## Quick Example
```rust
// OLD (serde)
use serde::{Serialize, Deserialize};
use serde_json;
#[derive(Serialize, Deserialize)]
struct Config {
name: String,
}
let config: Config = serde_json::from_str(json)?;
// NEW (facet)
use facet::Facet;
use facet_json as json;
#[derive(Facet)]
struct Config {
name: String,
}
let config: Config = json::from_str(json)?;
```
## Checking Dependencies
When adding new dependencies or reviewing code, check Cargo.toml for serde ecosystem crates and consider if facet alternatives exist.
## TODO for This Workspace
The benchmark-analyzer currently uses `serde_json` for JSON serialization in chart data. This should be migrated to `facet-json` for consistency (eating our own dogfood).
Location: `tools/benchmark-analyzer/src/report.rs` - uses `serde_json::to_string()` for chart labels/data.
© facet-rs · Apache-2.0 · facet-rs/facet