---
title: Concepts
description: How yoke-pi maps pi skills and the remaining migration work.
---

## Skills

A yoke-pi skill lives at `skills/<name>/SKILL.md` and follows the Agent Skills format: YAML frontmatter plus markdown instructions.

In pi, skills can be invoked explicitly:

```text
/skill:grill <topic>
/skill:gca
```

## Interactive questions

Pi-adapted yoke skills use the `ask_user` tool from `pi-ask-user` for structured choices.

Pattern:

- one focused question at a time;
- recommended option first;
- free-form answer enabled.

## Deprecated / port pending skills

Skills that still contain Claude Code-specific assumptions are marked with:

```yaml
disable-model-invocation: true
```

This keeps them available for explicit migration/debugging while preventing automatic model selection.

## Legacy agents and hooks

Some directories still contain Claude-era agents, hooks, and helper scripts. They are retained during soft cleanup but are not considered pi-native until ported.