dart-use-doc-examples
Позволяет внедрять примеры кода в Dartdoc через директиву {@example} и фильтровать файлы с помощью тегов #hide, #region и #endregion. Пригодится при написании документации для Dart-проектов.
AIflutter
official
Документы
★ 3k
Что делает навык
Навык позволяет внедрять примеры кода в Dartdoc через директиву {@example}, извлекая их в отдельные .dart файлы для возможности анализа, линтинга и выполнения. Он также предоставляет механизмы фильтрации файлов с помощью тегов #hide, #region и #endregion.
Когда применять
- Внедрение многострочных примеров кода в документацию вместо inline-комментариев.
- Использование конкретных языков разметки для подсветки синтаксиса в сгенерированной документации.
- Вставка фрагментов кода из внешних файлов с указанием конкретных регионов.
- Контроль отступов в отображаемом коде (сохранение или удаление).
Как работает
- Извлечь многострочные примеры кода в отдельные .dart файлы.
- Использовать директиву {@example} в комментариях документации.
- Указать путь к файлу и, при необходимости, регион (через #).
- Опционально задать язык разметки через параметр lang=LANGUAGE.
- Опционально настроить отступы через параметр indent=keep|strip.
Примеры запросов агенту
Вставь пример кода из файла example.dart в документацию с помощью директивы {@example}.
Используй фрагмент кода из региона setup в файле config.dart для документации.
Добавь пример кода с сохранением отступов и указанием языка dart.
Описание составлено по SKILL.md навыка, сверено 07.10.2026.
Как подключить
1Скачать навык
# возьмите папку навыка «flutter-dart-use-doc-examples» из репозитория:
# https://github.com/flutter/agent-plugins
2Положить папку с
SKILL.md к навыкам ассистента# положите папку навыка туда, где ассистент ищет skills:
cp -r flutter-dart-use-doc-examples/ ~/.claude/skills/flutter-dart-use-doc-examples/
Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.