Agent skill

Tilelang Pass Design

by tile-ai in tile-ai/tilelang-ascend

根据 Pass 需求生成 TileLang-Ascend Pass 设计文档(pass-design.md)。涵盖 Pass 定位分析(Phase 1/2归属、Pipeline位置、依赖关系)、IR 变换设计、C++ 实现方案、测试方案、风险分析等。触发关键词:设计 Pass、Pass 设计文档、写 Pass、实现 Pass、添加 Pass、新建 Pass、Pass 设计、开发 Pass。

MITAuto-check passedFrontend & Design

Install Tilelang Pass Design

skills CLI
$ npx skills add tile-ai/tilelang-ascend --skill tilelang-pass-design -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install tile-ai/tilelang-ascend tilelang-pass-design --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/tile-ai/tilelang-ascend.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/tilelang-pass-design .claude/skills/tilelang-pass-design && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
tilelang-pass-design
GitHub stars
403
Token cost
~1.6k tokens
SKILL.md length
530 words
Files
3 (incl. references)
Skills in repo
20
Repo updated
First seen
Licence
MIT

At a glance

根据 Pass 需求生成 TileLang-Ascend Pass 设计文档(pass-design.md)。涵盖 Pass 定位分析(Phase 1/2归属、Pipeline位置、依赖关系)、IR 变换设计、C++ 实现方案、测试方案、风险分析等。触发关键词:设计 Pass、Pass 设计文档、写 Pass、实现 Pass、添加 Pass、新建 Pass、Pass 设计、开发 Pass。

  • Works in 10 steps: 目标 → 输入要求 → 工作流程 → …
  • Tasks that involve Design tokens
  • SKILL.md covers 1. 目标, 2. 输入要求, 3. 工作流程 and 4. 定位决策速查表, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Tilelang Pass Design is an agent skill from tile-ai/tilelang-ascend. 根据 Pass 需求生成 TileLang-Ascend Pass 设计文档(pass-design.md)。涵盖 Pass 定位分析(Phase 1/2归属、Pipeline位置、依赖关系)、IR 变换设计、C++ 实现方案、测试方案、风险分析等。触发关键词:设计 Pass、Pass 设计文档、写 Pass、实现 Pass、添加 Pass、新建 Pass、Pass 设计、开发 Pass。

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/pass-impl-patterns.md` and `templates/pass-design-template.md`).

It sits in Frontend & Design, covering Design tokens. It works with C++. The repository describes itself as: Ascend TileLang adapter. The licence is MIT.

When your agent uses it

  • Tasks that involve Design tokens

Example prompts

  • “/tilelang-pass-design”

Requirements

  • Python 3

Workflow steps

10 steps, taken from the step headings in SKILL.md.

  1. 目标
  2. 输入要求
  3. 工作流程
  4. 定位决策速查表
  5. 质量自检清单
  6. 信息源优先级
  7. 错误处理
  8. 完成报告与关联引导
  9. 参考资料
  10. 与其他 Skill 的关系

What it can do on your machine

Read from SKILL.md and the folder at commit 83b0ece. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Tilelang Pass Design loads about 1.6k tokens when it runs, and up to ~4.9k if it reads all its reference files. Until then it costs about 54 tokens; SKILL.md has 530 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~54
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from tile-ai/tilelang-ascend at commit 83b0ece, republished under its MIT licence (© tile-ai). 530 words, ~1,583 tokens.

Download SKILL.mdSave it as .claude/skills/tilelang-pass-design/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
tilelang-pass-design
description
根据 Pass 需求生成 TileLang-Ascend Pass 设计文档(pass-design.md)。涵盖 Pass 定位分析(Phase 1/2归属、Pipeline位置、依赖关系)、IR 变换设计、C++ 实现方案、测试方案、风险分析等。触发关键词:设计 Pass、Pass 设计文档、写 Pass、实现 Pass、添加 Pass、新建 Pass、Pass 设计、开发 Pass。

TileLang-Ascend Pass 设计文档生成 Skill


1. 目标

根据 Pass 需求信息,生成一份完整的 TileLang-Ascend Pass 设计文档(pass-design.md),涵盖以下核心决策:

  • Pass 定位:Phase 1 / Phase 2 归属、Pipeline 具体位置
  • 依赖分析:上游 Pass 输入、下游 Pass 输出、数据流传递
  • IR 变换设计:输入 IR 结构、输出 IR 结构、变换逻辑
  • 实现方案:C++ 类设计、核心方法、Python Wrapper、Pipeline 集成
  • 测试方案:功能测试、依赖测试、边界测试
  • 风险分析:已知约束、常见错误、与其他 Pass 的交互

2. 输入要求

必需信息
字段说明
Pass 名称如 BufferReuseOptimizer、L0CLayoutOptimization
功能描述Pass 要解决的问题和目标
IR 变换类型修改 IR / 收集信息 / 验证 IR
平台范围平台无关 / Ascend 特定

提问规则(必须严格遵守):

  1. 每次只询问一个字段:使用 question 工具时,questions 数组中只包含一个元素
  2. 按表格顺序依次询问:Pass 名称 → 功能描述 → IR 变换类型 → 平台范围
  3. 已提供的字段跳过:如果用户在初始请求中已提供某个字段的值,跳过该字段继续下一个
推荐信息
字段说明
参考 Pass可参考的现有 Pass 名称
输入数据依赖Pass 需要哪些 attrs(如 buffer_shapess、address_map)
输出数据供给Pass 产生哪些 attrs 供下游使用
性能目标Pass 对编译时间或生成代码性能的影响

3. 工作流程

Phase 1:需求澄清
  1. 解析用户提供的 Pass 需求信息
  2. 检查必需字段是否完整
  3. 按顺序逐一提问补全缺失字段(每次只问一个)
Phase 2:信息收集
  1. 查阅 Pass 定位参考资料:

    • tilelang-pass-workflow-analyzer/references/pass-pipeline-overview.md - Pipeline 架构
    • tilelang-pass-workflow-analyzer/references/new-pass-placement-guide.md - 定位决策流程
    • tilelang-pass-workflow-analyzer/references/pass-dependency-graph.md - 依赖关系
  2. 查阅 Pass 实现参考资料:

    • tilelang-pass-analyzer/references/pass-registry-ascend.md - 类似 Pass 实现
    • tilelang-pass-analyzer/references/ir-examples.md - IR 变换示例格式
  3. 查阅本 skill 的实现模式参考:

    • references/pass-impl-patterns.md - C++ 类模板、注册方式
Phase 3:Pass 定位分析

按照 new-pass-placement-guide.md 的决策流程:

Step 1:分析 Pass 功能

  • Pass 的主要功能是什么?
  • Pass 修改 IR 还是收集信息?
  • Pass 是平台无关还是 Ascend 特定?
  • Pass 属于哪类优化(Lowering / 合法化 / 内存 / 流水线 / 同步 / 其他)?

Step 2:分析依赖关系

  • Pass 需要哪些输入数据(attrs)?
  • 这些数据由哪个 Pass 产生?
  • Pass 产生哪些输出数据?
  • 这些数据由哪个 Pass 使用?

Step 3:确定阶段归属

  • DSL Lowering / IR 合法化 → Phase 1
  • 硬件优化 / 内存优化 / 同步优化 → Phase 2
  • 输入数据来自 Phase 1 → 可在 Phase 1 或 Phase 2
  • 输入数据来自 Phase 2 → 必须在 Phase 2

Step 4:确定具体位置

  • 依赖优先:Pass 必须在产生其输入数据的 Pass 后执行
  • 供给优先:Pass 必须在使用其输出数据的 Pass 前执行
  • 功能相邻:将 Pass 放在功能相似的 Pass 附近
Phase 4:生成 pass-design.md

基于 templates/pass-design-template.md 模板,填充所有章节:

  1. 概述
  2. Pass 定位
  3. IR 变换设计
  4. 实现方案
  5. 测试方案
  6. 风险点与注意事项
  7. 交付清单
Phase 5:质量自检

按照 §5 中的自检清单逐项检查,确保文档质量。

Phase 6:针对性修订

仅修正未通过自检的项目。信息确实不足的标注为「待确认」并说明原因。

Phase 7:输出与关联引导
  1. 将 pass-design.md 输出到当前目录或用户指定路径
  2. 若文件已存在,询问是否覆盖
  3. 关联引导:提示用户可使用相关 skill 查看详细信息

4. 定位决策速查表

阶段归属速查
Pass 功能特征阶段归属理由
DSL LoweringPhase 1将高级 DSL 转换为底层 IR
IR 合法化Phase 1确保 lowered IR 符合规范
信息收集Phase 1 或 Phase 2根据收集时机决定
硬件优化Phase 2针对 Ascend 硬件特性优化
内存优化Phase 2利用硬件内存层级优化
流水线优化Phase 2多核流水线规划
同步优化Phase 2多核同步策略
Show full SKILL.md (218 more words)Show less
典型定位场景
Pass 功能特征推荐位置
IR 合法化检查Phase 1 末尾
新 Tile 操作 LoweringPhase 1,LowerTileOp 后
内存优化Phase 2,AscendStorageRewrite 后,AscendMemoryPlanning 前
同步优化Phase 2,AscendMemoryPlanning 后,AscendSyncInsert 前
流水线优化Phase 2,PipelinePlanning 后
信息收集根据收集内容类型决定
关键数据依赖
输入数据产生 Pass阶段
buffer scopeAscendInferBufferScopePhase 1
buffer_shapessCollectBufferShapesPhase 1
address_mapAscendMemoryPlanningPhase 2
size_mapAscendMemoryPlanningPhase 2

5. 质量自检清单

生成 pass-design.md 后,逐项检查:

#检查项是否必须通过
1阶段归属有明确结论和理由:不是「视情况而定」✅ 必须
2Pipeline 位置具体到步骤:如「Phase 2 步骤 13,在 X Pass 后」✅ 必须
3依赖关系完整:上游 Pass + 下游 Pass + 数据传递✅ 必须
4IR 变换有输入/输出示例:伪 IR 格式,标注变化点✅ 必须
5C++ 类名和核心方法明确:具体到类名和关键方法名✅ 必须
6Pipeline 集成代码完整:包含集成到 phase.py 的代码片段✅ 必须
7无占位符或模糊描述:无 {placeholder}、TODO、「待补充」✅ 必须

通过条件:所有必须项全部通过。


6. 信息源优先级

优先级信息源用途
1tilelang-pass-workflow-analyzer/references/Pass 定位、依赖分析
2tilelang-pass-analyzer/references/Pass 实现参考、IR 变换示例
3references/pass-impl-patterns.md(本 skill)C++ 类模板、注册方式
4tilelang/engine/phase.pyPipeline 集成参考
5src/transform/*.cc典型实现模式(仅在追问时使用)

冲突处理:当信息源之间矛盾时,以 pass-pipeline-overview.md 和 new-pass-placement-guide.md 为准。


7. 错误处理

场景处理方式
用户未提供 Pass 名称提问补全
必需字段缺失列出缺失项,逐一提问
无法确定阶段归属分析依赖关系后给出推荐方案,标注为「需确认」
目标文件已存在询问用户是否覆盖或另存
Pass 功能过于复杂建议拆分为多个子 Pass 分别设计

8. 完成报告与关联引导

文档生成完成后,输出以下格式的报告:

## Pass 设计文档生成报告

- Pass 名称: {Pass 名称}
- 阶段归属: {Phase 1 / Phase 2}
- Pipeline 位置: {具体位置描述}
- IR 变换类型: {修改 IR / 收集信息 / 验证 IR}
- 输出路径: {文件路径}

### 自检结果
1. 阶段归属明确: ✅ / ❌
2. Pipeline 位置具体: ✅ / ❌
3. 依赖关系完整: ✅ / ❌
4. IR 变换示例清晰: ✅ / ❌
5. C++ 实现方案明确: ✅ / ❌
6. Pipeline 集成代码完整: ✅ / ❌
7. 无占位符: ✅ / ❌

### 待确认项
- {列出需要用户进一步确认的内容}

### 后续步骤建议
1. 查看详细 Pass 工作流:使用 **tilelang-pass-workflow-analyzer** skill
2. 查看类似 Pass 实现:使用 **tilelang-pass-analyzer** skill
3. 开始实现 Pass:使用 **tilelang-pass-generate** skill

9. 参考资料

本 skill 依赖以下参考文件:

文件路径用途
Pass 定位指南tilelang-pass-workflow-analyzer/references/new-pass-placement-guide.md定位决策流程
Pipeline 架构tilelang-pass-workflow-analyzer/references/pass-pipeline-overview.md阶段划分、Pass 列表
依赖关系图tilelang-pass-workflow-analyzer/references/pass-dependency-graph.md数据流分析
Pass 注册表tilelang-pass-analyzer/references/pass-registry-ascend.md类似 Pass 参考
IR 示例tilelang-pass-analyzer/references/ir-examples.mdIR 变换格式
实现模式references/pass-impl-patterns.md(本 skill)C++ 模板代码

10. 与其他 Skill 的关系

Skill关系使用时机
tilelang-pass-workflow-analyzer依赖查阅 Pipeline 架构、Pass 定位、依赖关系
tilelang-pass-analyzer依赖查阅现有 Pass 实现细节、IR 变换示例
tilelang-pass-generate后续根据设计文档生成 Pass 代码(先输出 pass-impl-skeleton.md 框架,再落 C++/Python/Pipeline/测试)

© tile-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in .agents/skills/tilelang-pass-design of tile-ai/tilelang-ascend.

  • SKILL.md
  • references/pass-impl-patterns.md
  • templates/pass-design-template.md

Open the folder on GitHubat commit 83b0ece

Compare with similar skills

Tilelang Pass Design next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Tilelang Pass Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tilelang Pass Design this skilltile-ai/tilelang-ascend403—~1.6kAutomated safety check: PassMIT
Figma Design System Builderwarpdotdev/warp65k2 repos~4.4kAutomated safety check: PassAGPL-3.0
Figma use_figma Plugin API Ruleswarpdotdev/warp65k4 repos~4.4kAutomated safety check: PassAGPL-3.0
MCP Developmentcoollabsio/coolify63k1 repos~949Automated safety check: PassMIT
Design SystemOhh-889/skyroc79511 repos~1.7kAutomated safety check: PassMIT
Design Dnazanwei/design-dna1.9k1 repos~2.1kAutomated safety check: PassMIT

Similar skills

  • Builds or updates a design system in Figma from a codebase in ordered phases: discovery, variables and tokens, components, theming and documentation, with checkpoints.

    65k GitHub starsUsed in 2 repos~4.4k tokens
    Frontend & DesignAuto-check passed
  • Required groundwork before any use_figma call: the rules and reference files for running JavaScript in a Figma file through the Plugin API without common failures.

    65k GitHub starsUsed in 4 repos~4.4k tokens
    Frontend & DesignAuto-check passed
  • MCP Development

    coollabsio/coolify

    A skill your agent uses for Laravel MCP development. An agent skill from coollabsio/coolify.

    63k GitHub starsUsed in 1 repo~949 tokens
    Frontend & DesignAuto-check passed
  • Design System

    Ohh-889/skyroc

    Token architecture, component specifications, and slide generation.

    795 GitHub starsUsed in 11 repos~1.7k tokens
    Frontend & DesignAuto-check passed
  • Design Dna

    zanwei/design-dna

    Extract, define, and apply design DNA across three dimensions: design system (tokens), design style (qualitative feel), and visual effects (Canvas, WebGL, 3D, particles, shaders, scroll effects…

    1.9k GitHub starsUsed in 1 repo~2.1k tokens
    Frontend & DesignAuto-check passed
  • Figma Design to Code

    warpdotdev/warp

    Turns a Figma frame or component into production code that matches the design, using the Figma MCP server and the project's own design system.

    65k GitHub starsUsed in 4 repos~2.9k tokens
    Frontend & DesignAuto-check passed

More from tile-ai/tilelang-ascend

All 20 skills in this repo
  • Tilelang Submodule Pull

    tile-ai/tilelang-ascend

    Automatically pull tilelang repository and its third-party code.

    403 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed
  • Tilelang Debug Helper

    tile-ai/tilelang-ascend

    How to add debugging capabilities to TileLang Ascend example operators.

    403 GitHub stars~1.7k tokensUpdated yesterday
    Auto-check: notes
  • Tilelang A5 Sim Convert

    tile-ai/tilelang-ascend

    将 tilelang example 脚本转换为可在 A5 camodel 仿真器上直接运行的版本。输入脚本路径,输出一个新的 sim.py 文件,不覆盖原始文件。触发:仿真运行、camodel、A5 仿真、sim 模式、转换脚本为仿真、不需要 NPU 跑 kernel、simulate A5。

    403 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Tilelang Env Check

    tile-ai/tilelang-ascend

    TileLang-Ascend 环境检查与配置验证技能。检查代码仓库完整性、编译安装状态、环境变量配置,并运行简单测试验证环境。发现问题会自动调用相关 skill 进行修复,并按依赖顺序重新执行后续步骤。触发关键词:"环境检查"、"检查环境"、"验证环境"、"环境配置"、"环境搭建"、"env check"、"check environment"、"verify…

    403 GitHub stars~3.4k tokensUpdated yesterday
    Auto-check passed
  • Tilelang Op Test Design

    tile-ai/tilelang-ascend

    TileLang-Ascend 算子测试设计技能。支持多种场景:(1) 从 design.md 设计测试配置 (2) 从 examples/{op}/.py 补充测试 (3) 手动提供算子信息生成测试 (4) 测试覆盖率分析。理解算子实现逻辑后智能判断测试策略。触发:设计算子测试、生成测试用例、补充测试、测试覆盖率不足。

    403 GitHub stars~5.6k tokensUpdated yesterday
    Auto-check passed
  • Tilelang Review

    tile-ai/tilelang-ascend

    检查代码格式是否符合 CI 规则。自动检测并安装缺失工具(ruff、clang-format),先运行检查生成报告,使用醒目方式询问用户后,仅在用户同意时执行修复。工作流程:检测环境→自动安装缺失工具→运行检查→生成报告→醒目询问→用户确认→执行修复。使用此技能当:用户要求"格式检查"、"格式化代码"、"代码格式化"、"检查代码格式"、"代码…

    403 GitHub stars~2.8k tokensUpdated yesterday
    Auto-check: notes

Works with

Questions about Tilelang Pass Design

What does Tilelang Pass Design do?

根据 Pass 需求生成 TileLang-Ascend Pass 设计文档(pass-design.md)。涵盖 Pass 定位分析(Phase 1/2归属、Pipeline位置、依赖关系)、IR 变换设计、C++ 实现方案、测试方案、风险分析等。触发关键词:设计 Pass、Pass 设计文档、写 Pass、实现 Pass、添加 Pass、新建 Pass、Pass 设计、开发 Pass。. Tilelang Pass Design is an agent skill from tile-ai/tilelang-ascend.

When should I use Tilelang Pass Design?

Tilelang Pass Design fits situations like: tasks that involve Design tokens.

How do I install Tilelang Pass Design in Claude Code?

Run `npx skills add tile-ai/tilelang-ascend --skill tilelang-pass-design -a claude-code`. Or copy the skill folder (.agents/skills/tilelang-pass-design in tile-ai/tilelang-ascend) into .claude/skills/tilelang-pass-design in your project. Claude Code loads it when a task matches its description.

How do I install Tilelang Pass Design in Codex?

Run `npx skills add tile-ai/tilelang-ascend --skill tilelang-pass-design -a codex`. Or copy the skill folder (.agents/skills/tilelang-pass-design in tile-ai/tilelang-ascend) into .agents/skills/tilelang-pass-design in your project. Codex loads it when a task matches its description.

Can I use Tilelang Pass Design in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add tile-ai/tilelang-ascend --skill tilelang-pass-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tilelang-pass-design, .gemini/skills/tilelang-pass-design, .github/skills/tilelang-pass-design and .opencode/skills/tilelang-pass-design in your project.

What does Tilelang Pass Design need to run?

SKILL.md names no scripts, command-line tools or credentials: Tilelang Pass Design is instructions for the agent only. Our summary lists: Python 3.

Does Tilelang Pass Design access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Tilelang Pass Design safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Tilelang Pass Design use?

Tilelang Pass Design is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Tilelang Pass Design use?

About 1.6k tokens (SKILL.md is roughly 6.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.4k tokens, read only when the agent opens those files.

What are the alternatives to Tilelang Pass Design?

Skills that share tags, products or a category with Tilelang Pass Design: Figma Design System Builder (warpdotdev/warp, 65k stars), Figma use_figma Plugin API Rules (warpdotdev/warp, 65k stars), MCP Development (coollabsio/coolify, 63k stars) and Design System (Ohh-889/skyroc, 795 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tilelang Pass Design?

tile-ai (a GitHub organization) maintains it in tile-ai/tilelang-ascend, which has 403 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on October 9, 2026.

Source: tile-ai/tilelang-ascend on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.