Installation

The Linguistic Agent Skills suite is a directory of Claude Code Skills and slash commands. Installation means placing them where Claude Code can find them.

Prerequisites

Claude Code (latest) — the skills activate as part of Claude Code sessions
Python 3.10+ — required for the utility scripts (scripts/ directory)
Git — for cloning the repo

Clone the Repository

git clone https://github.com/Votee-AI/magic-linguistic-agent-skills.git linguistic-agent-skills
cd linguistic-agent-skills

Python Dependencies

python3 -m venv .venv
source .venv/bin/activate
pip install --upgrade pip
pip install -r requirements.txt

requirements.txt pins: pytest, pyyaml, ruff>=0.4,<0.5, mypy>=1.10,<2.0, types-PyYAML>=6.0,<7.0.

Link Skills and Commands into Claude Code

ln -s "$(pwd)/skills" ~/.claude/skills/linguistic
ln -s "$(pwd)/commands" ~/.claude/commands/linguistic

After symlinking, Claude Code will automatically route to the appropriate linguistic specialist whenever you mention a target language or use a /linguistic: slash command.

Verify Installation

Start a Claude Code session and type:

/linguistic:help

You should see the command table listing all 10 slash commands and their natural-language triggers.

Alternatively, use a natural-language trigger:

help me build an LLM for Yoruba

The linguistic-orchestrator skill should activate and route to linguistic-scope for language disambiguation.

Verify Python Environment

ruff --version          # 0.4.x or 0.5.x
mypy --version          # 1.10+
pytest --version        # 7.0+
python3 -c "import yaml; print(yaml.__version__)"  # 6.0+

Run Tests

pytest tests/ -q

All 226 tests should pass on Python 3.10/3.11/3.12.

IDE Configuration

Editor	Recommended Extensions
VSCode	Python (ms-python.python), Ruff (charliermarsh.ruff), mypy (ms-python.mypy-type-checker)
PyCharm	Built-in Python interpreter pointing at `.venv/bin/python`; Ruff plugin from JetBrains Marketplace
Vim/Neovim	`ruff-lsp` via your LSP setup

Do not commit .vscode/settings.json or .idea/ — IDE configuration is per-developer.

Project Structure After Installation

linguistic-agent-skills/
├── skills/
│   ├── _linguistic_shared/        # Shared utilities
│   ├── linguistic-orchestrator/   # Entry point
│   ├── linguistic-scope/          # Phase 0
│   ├── linguistic-scripts/        # Phase 0
│   ├── linguistic-tokenize/       # Phase 0
│   ├── linguistic-ethics/         # Phase 0 + Release gate
│   ├── linguistic-corpus/         # Phase 1
│   ├── linguistic-bitext/         # Phase 1
│   ├── linguistic-transfer/       # Phase 1
│   ├── linguistic-morph/          # Phase 2
│   ├── linguistic-syntax/         # Phase 2
│   ├── linguistic-annotate/       # Phase 2
│   ├── linguistic-semantics/      # Phase 2
│   ├── linguistic-discourse/      # Phase 2
│   ├── linguistic-speech/         # Phase 2
│   ├── linguistic-eval/           # Phase 3
│   ├── linguistic-codeswitch/     # Phase 4 (optional)
│   ├── linguistic-historical/     # Phase 4 (optional)
│   └── linguistic-lexicon/        # Phase 4 (optional)
└── commands/linguistic/           # 10 slash commands

Was this page helpful?

On this page