Agent skill

Tech Review

by azukiazusa1 in azukiazusa1/sapper-blog-app

技術ブログ記事、チュートリアル、技術原稿を、技術的正確性、一次情報、現在の API 挙動、コード、再現性、セキュリティ、アクセシビリティ、互換性の観点からレビューする。技術的な主張、コードサンプル、対応バージョン、仕様、公開前の正確性を確認してほしいと依頼されたときに使用する。一般的な文章校正は article-review に任せ、明示的な依頼なしに原稿を変更しない。

MITAuto-check passed

Install Tech Review

skills CLI
$ npx skills add azukiazusa1/sapper-blog-app --skill tech-review -a claude-code

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

GitHub CLI
$ gh skill install azukiazusa1/sapper-blog-app tech-review --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/azukiazusa1/sapper-blog-app.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/tech-review .claude/skills/tech-review && 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
tech-review
GitHub stars
189
Token cost
~591 tokens
SKILL.md length
53 words
Files
4 (incl. scripts, references)
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

技術ブログ記事、チュートリアル、技術原稿を、技術的正確性、一次情報、現在の API 挙動、コード、再現性、セキュリティ、アクセシビリティ、互換性の観点からレビューする。技術的な主張、コードサンプル、対応バージョン、仕様、公開前の正確性を確認してほしいと依頼されたときに使用する。一般的な文章校正は article-review に任せ、明示的な依頼なしに原稿を変更しない。

  • Works in 4 steps: 記事に対応する完全な検証用プロジェクトと記録されたコマンド → リポジトリで既に利用できるテスト、ビルド、型検査 → 記事のコードと検証済みコードの一致 → …
  • SKILL.md covers 対象と範囲を把握する, 根拠と現在の挙動を確認する, コードを比例的に検証する and 指摘を報告する, plus 1 more section
  • Runs Python scripts from its folder; calls python3

What it does

Tech Review is an agent skill from azukiazusa1/sapper-blog-app. 技術ブログ記事、チュートリアル、技術原稿を、技術的正確性、一次情報、現在の API 挙動、コード、再現性、セキュリティ、アクセシビリティ、互換性の観点からレビューする。技術的な主張、コードサンプル、対応バージョン、仕様、公開前の正確性を確認してほしいと依頼されたときに使用する。一般的な文章校正は article-review に任せ、明示的な依頼なしに原稿を変更しない。

Its SKILL.md is about 590 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `agents/openai.yaml`, `references/technical-checklist.md` and `scripts/run_code_samples.py`).

The licence is MIT.

Example prompts

  • “/tech-review”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. 記事に対応する完全な検証用プロジェクトと記録されたコマンド
  2. リポジトリで既に利用できるテスト、ビルド、型検査
  3. 記事のコードと検証済みコードの一致
  4. 完全なサンプルがない場合の、独立して実行可能なコードブロックの検査

What it can do on your machine

Read from SKILL.md and the folder at commit 7f7e8e1. 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

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    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

Tech Review loads about 591 tokens when it runs, and up to ~1.1k if it reads all its reference files. Until then it costs about 50 tokens; SKILL.md has 53 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from azukiazusa1/sapper-blog-app at commit 7f7e8e1, republished under its MIT licence (© azukiazusa1). 53 words, ~591 tokens.

Download SKILL.mdSave it as .claude/skills/tech-review/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
tech-review
description
技術ブログ記事、チュートリアル、技術原稿を、技術的正確性、一次情報、現在の API 挙動、コード、再現性、セキュリティ、アクセシビリティ、互換性の観点からレビューする。技術的な主張、コードサンプル、対応バージョン、仕様、公開前の正確性を確認してほしいと依頼されたときに使用する。一般的な文章校正は article-review に任せ、明示的な依頼なしに原稿を変更しない。

技術的正確性をレビューする

懐疑的なエンジニアと読者の立場から、記事の正しさ、根拠、再現性と、読者が手順を実行した場合の影響を確認する。

対象と範囲を把握する

Markdown、MDX、貼り付けた原稿、または明確に特定された記事を受け付ける。記事全体と、利用可能な検証用プロジェクト、設定、依存関係を読む。想定読者と記事タイプは可能な限り原稿から推定し、欠けた情報が検証を妨げる場合だけ質問する。

既定ではレビューだけを行い、ファイルを変更しない。編集はユーザーが明示的に依頼した場合だけ行う。

references/technical-checklist.md を読み、次を特定する。

  • 中心的な主張と結論
  • バージョンや時期に依存する記述
  • 仕様や API に関する規範的な主張
  • 実行を意図したコード
  • 検証環境と観測結果
  • セキュリティ、プライバシー、アクセシビリティ、互換性、運用上の影響

根拠と現在の挙動を確認する

変更され得る情報、参照された資料、現在の対応状況は Web で確認する。仕様、公式ドキュメント、公式リポジトリ、リリースノート、標準化の議論、公式テストを優先する。検索結果の要約だけで判断せず、リンク先を読む。

規範的要件、実装固有の挙動、過去の提案、著者の推測、意見を区別する。資料にない設計理由を作らない。引用した資料が、記事中の近接する主張を実際に裏付けているか確認する。

コードを比例的に検証する

検証の優先順位を次のとおりにする。

  1. 記事に対応する完全な検証用プロジェクトと記録されたコマンド
  2. リポジトリで既に利用できるテスト、ビルド、型検査
  3. 記事のコードと検証済みコードの一致
  4. 完全なサンプルがない場合の、独立して実行可能なコードブロックの検査

記事の主張に関係する検証だけを選び、可能なら対象サンプルやパッケージに範囲を絞る。必要な検証が通ったら終了し、新しい変更、失敗、未解決の懸念がなければ検証を拡大・反復しない。修正後の再検証は、修正箇所と影響する主張を対象にする。

Markdown のコードブロックは前後の状態や省略部分に依存することがあるため、単体実行の失敗だけで記事の誤りと断定しない。JavaScript、TypeScript、JSX、TSX の独立したコードブロックを補助的に確認する場合は、内容が安全で外部サービスや認証情報を含まないことを確認してから実行する。

bash
python3 .claude/skills/tech-review/scripts/run_code_samples.py <記事ファイル>

スクリプトはインストール済みの node、tsx、ts-node、tsc だけを利用する。公開資料の読み取りと既存環境での安全なローカル検証は、その都度承認を求めず進める。パッケージの追加・依存関係の取得、課金を伴う実行、外部サービスのデータ更新、システムフラグの変更には、対象と操作を含むユーザーの承認が必要である。同じ対象・操作について承認済みなら再確認しない。承認は実行環境の権限を拡張するものではない。破壊的、認証情報を含む、本番環境を対象とするコードは実行しない。

実行した場合は、コマンド、環境、結果、記事との差を記録する。実行できない場合は静的レビューに切り替えて制約を明示する。構文チェックの成功を実行時挙動の証明として扱わない。

指摘を報告する

重要度順、同じ重要度では行番号順に並べる。

  • P0: 危険、根本的に誤り、または公開を止める問題
  • P1: 公開前に直すべき実質的な技術的誤り
  • P2: 正確性、根拠、再現性を有意に改善する問題
  • P3: 任意の技術的改善
text
[P1] 短い指摘タイトル
Location: contents/blogPost/example.md:42
Impact: 読者または実行結果への具体的な影響
Evidence: 問題を確立する一次情報、実行結果、または推論
Suggestion: 具体的な修正または検証手順

根拠へのリンクは主張の近くに置き、同じ原因の指摘はまとめる。確認できなかったという理由だけで誤りと断定しない。根拠によって問題を確立した指摘と、未確認事項・検証の制約を分け、後者には不足している証拠と確認方法を記す。指摘がなければその旨と、完了できなかった重要な検証を列挙する。求められない限り良い点のセクションを作らず、技術的意味を変えない文章上の問題は article-review に任せる。

依頼された修正を適用する

ユーザーが修正を依頼した場合だけ、根拠で確立できる客観的な訂正を適用する。論旨、範囲、アーキテクチャ、筆者の意見を変える前に合意を得る。修正後は影響する検証を再実行し、変更ファイル、コマンド、結果、未解決事項を報告する。

© azukiazusa1, 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 3 other files (scripts, references) in .claude/skills/tech-review of azukiazusa1/sapper-blog-app.

  • SKILL.md
  • agents/openai.yaml
  • references/technical-checklist.md
  • scripts/run_code_samples.py

Open the folder on GitHubat commit 7f7e8e1

Compare with similar skills

Tech Review 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.

Tech Review compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tech Review this skillazukiazusa1/sapper-blog-app189—~591Automated safety check: PassMIT
Tech Matrixsickn33/agentic-awesome-skills47k1 repos~3.1kAutomated safety check: PassMIT
Tech Debt Auditcode-yeongyu/oh-my-openagent70k—~2.4kAutomated safety check: NotesCustom licence
HTML Ppt Tech Sharingnexu-io/open-design100k—~1.3kAutomated safety check: PassApache-2.0
Tech Debt RegisterDonchitos/Claude-Code-Game-Studios26k—~2.4kAutomated safety check: PassMIT
Tech Resume Optimizerdavila7/claude-code-templates33k1 repos~2.7kAutomated safety check: PassMIT

Similar skills

  • Tech Matrix

    sickn33/agentic-awesome-skills

    Reference document for monopoly tech-matrix. An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 1 repo~3.1k tokens
    Backend & APIsAuto-check passed
  • Tech Debt Audit

    code-yeongyu/oh-my-openagent

    Audits a codebase for technical debt across nine dimensions and writes TECH_DEBT_AUDIT.md with file-cited findings, severity, effort estimates and priorities.

    70k GitHub stars~2.4k tokensUpdated today
    DevelopmentAuto-check: notes
  • HTML Ppt Tech Sharing

    nexu-io/open-design

    OpenDesign internals: how the agent stream, sandbox, and artifacts work — an engineering deep-dive talk.

    100k GitHub stars~1.3k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Tech Debt Register

    Donchitos/Claude-Code-Game-Studios

    Scans a codebase for debt indicators, sorts findings into six debt categories and maintains a prioritized register you can add to, re-rank and report on.

    26k GitHub stars~2.4k tokensUpdated 3 days ago
    DevelopmentAuto-check passed
  • Tech Resume Optimizer

    davila7/claude-code-templates

    Optimize resumes for software engineering, product management, and technical roles.

    33k GitHub starsUsed in 1 repo~2.7k tokens
    Business, Finance & HRAuto-check passed
  • Tech Debt Tracker

    alirezarezvani/claude-skills

    Scan codebases for technical debt, score severity, track trends, and generate prioritized remediation plans.

    28k GitHub starsUsed in 1 repo~1.2k tokens
    DevelopmentAuto-check passed

More from azukiazusa1/sapper-blog-app

  • Codepen Share

    azukiazusa1/sapper-blog-app

    ローカルで検証済みのブラウザ向け HTML、CSS、JavaScript を CodePen Prefill launcher に変換し、承認後に未保存の Pen を開く。フロントエンドのデモを CodePen で共有して、記事へ埋め込む準備をして、と依頼されたときに使用する。Node.js、サーバー、CLI、ビルド、複数プロセスが必要な例には使用しない。

    189 GitHub stars~438 tokensUpdated yesterday
    Auto-check passed
  • Write Blog Article

    azukiazusa1/sapper-blog-app

    ユーザーが新しい技術を学ぶことを第一目的として、このリポジトリの文体と構成に従い、調査、構成合意、サンプル実装・検証、執筆、レビュー、理解度クイズまでを行って技術ブログ記事の下書きを作成する。ユーザーがブログ記事を書いて、新しい API や機能を紹介して、ハンズオンを作って、技術調査を記事化して、経験や意見を記事にして、と依頼したときに使用する。新しい API・Web…

    189 GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed
  • Q

    azukiazusa1/sapper-blog-app

    技術記事の内容から読者の理解度をチェックする4択クイズを指定のYAML形式で生成するスキル。ユーザーが「この記事のクイズを作って」「理解度チェックを作成して」「記事を読んだ人向けの問題を作って」「selfAssessment形式でクイズを作って」と依頼したときに必ず使う。ブログ記事、技術ドキュメント、チュートリアル、解説記事、技術書の章など、読者の学習内容を確認する問題を作る必要があるあらゆる場…

    189 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed
  • Article Review

    azukiazusa1/sapper-blog-app

    引数で指定した記事のレビューを行います。記事スラッグを引数に渡すと、textlint による自動校正と誤字脱字・文法的な誤りの指摘を行います。/article-review [スラッグ] の形式で呼び出してください。記事を書いた後のチェック、公開前の校正、文章の品質確認にも使用してください。

    189 GitHub stars~574 tokensUpdated yesterday
    Auto-check passed
  • Translate

    azukiazusa1/sapper-blog-app

    記事を英語に翻訳する。記事スラッグを引数に渡すと、日本語の記事を英語に翻訳して contents/blogPost/en/ に出力する。/translate [スラッグ] の形式で呼び出す。

    189 GitHub stars~312 tokensUpdated yesterday
    Auto-check passed

Questions about Tech Review

What does Tech Review do?

技術ブログ記事、チュートリアル、技術原稿を、技術的正確性、一次情報、現在の API 挙動、コード、再現性、セキュリティ、アクセシビリティ、互換性の観点からレビューする。技術的な主張、コードサンプル、対応バージョン、仕様、公開前の正確性を確認してほしいと依頼されたときに使用する。一般的な文章校正は article-review に任せ、明示的な依頼なしに原稿を変更しない。. Tech Review is an agent skill from azukiazusa1/sapper-blog-app.

How do I install Tech Review in Claude Code?

Run `npx skills add azukiazusa1/sapper-blog-app --skill tech-review -a claude-code`. Or copy the skill folder (.claude/skills/tech-review in azukiazusa1/sapper-blog-app) into .claude/skills/tech-review in your project. Claude Code loads it when a task matches its description.

How do I install Tech Review in Codex?

Run `npx skills add azukiazusa1/sapper-blog-app --skill tech-review -a codex`. Or copy the skill folder (.claude/skills/tech-review in azukiazusa1/sapper-blog-app) into .agents/skills/tech-review in your project. Codex loads it when a task matches its description.

Can I use Tech Review 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 azukiazusa1/sapper-blog-app --skill tech-review -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tech-review, .gemini/skills/tech-review, .github/skills/tech-review and .opencode/skills/tech-review in your project.

What does Tech Review need to run?

Going by SKILL.md and its folder, Tech Review needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Tech Review 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 Tech Review 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Tech Review use?

Tech Review 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 Tech Review use?

About 591 tokens (SKILL.md is roughly 2.4k 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 539 tokens, read only when the agent opens those files.

What are the alternatives to Tech Review?

Skills that share tags, products or a category with Tech Review: Tech Matrix (sickn33/agentic-awesome-skills, 47k stars), Tech Debt Audit (code-yeongyu/oh-my-openagent, 70k stars), HTML Ppt Tech Sharing (nexu-io/open-design, 100k stars) and Tech Debt Register (Donchitos/Claude-Code-Game-Studios, 26k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tech Review?

azukiazusa1 (a GitHub user) maintains it in azukiazusa1/sapper-blog-app, which has 189 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on October 10, 2026.

Source: azukiazusa1/sapper-blog-app on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.