Agent Skill Kit Ask

🚀 🤖 Agent-Skill-Kit (ASK) v2.0

Agent-Skill-Kit (ASK) v2.0は、AIエージェント向けのローカルファーストなスキルフレームワークです。APIキーやサインアップ不要で、簡単にクローン、実行、統合ができます。

🚀 クイックスタート

# GitHubからインストール
pip install git+https://github.com/HughKnightOCE/Agent-Skill-Kit-ASK-.git

# 利用可能なスキルを表示
ask dashboard

# スキルを実行
ask run tech-pulse
ask run repo-visualizer
ask run architect "Your idea"

これだけです！.envファイルやAPIキーの探索、OAuthリダイレクトは不要です。

✨ 主な機能

🔌 MCPサーバー統合

スキルはcore/mcp_gateway.pyを通じて、ネイティブなMCPツールとして公開されます。ClaudeやCopilotはカスタム統合なしで直接スキルを発見して実行できます。

# Claudeはすべてのスキルをネイティブツールとして認識できるようになります
python core/mcp_gateway.py

🏗️ The Architectスキル

自然言語の説明から新しいスキルを生成します。The Architectは瞬時にスケルトンPythonスクリプトとYAMLマニフェストを作成します。

ask run architect "Convert CSV to JSON format"

💫 Living README

GitHub Actionsが24時間ごとにTech-Pulseを自動実行し、このREADMEの「Today's Agent Intelligence」セクションを更新します。これにより、リポジトリが稼働中で機能していることが証明されます。

🎨 高機能ターミナルUI

以下の機能を備えた強化されたTUIです。

• ASCIIアートバナー (ASK-2026)
• システムヘルスダッシュボード
• リアルタイムの進捗表示
• プロフェッショナルな色分け出力

🖥️ デスクトップGUIアプリケーション (NEW!)

以下の機能を備えた最新のPyQt6デスクトップインターフェイスです。

• スキルブラウザ - すべての利用可能なスキルを検索およびフィルタリング
• ビジュアルエグゼキュータ - 美しいフォーム入力でスキルを実行
• リアルタイム出力 - スキルの実行をリアルタイムで監視
• 履歴追跡 - 過去のスキル実行を確認
• ダッシュボード - システム統計とスキルカテゴリを表示
• プロフェッショナルなデザイン - 洗練されたネイティブデスクトップアプリケーション感

ask-guiで起動します。

🎯 Four Zero-Config Skills

1. Repo-Visualizer 📊

プロジェクト構造のMermaid.jsクラス図を即座に生成します。

ask run repo-visualizer /path/to/project

出力: ドキュメントに貼り付けたり、AIエージェントに渡したりできるクリーンなMermaid図。

graph TD
    Root["MyProject"]
    Root --> skills["📁 skills"]
    Root --> core["📁 core"]
    skills --> visualizer["📁 repo-visualizer"]

2. Agent-Identity 🎭

無料のDiceBear APIを使用して、プロジェクトのユニークなSVGアバターを生成します。

ask run agent-identity "Agent-Skill-Kit"

出力: ディスクに保存され、表示される美しい決定論的なSVGアバター。

<svg viewBox="0 0 100 100" xmlns="http://www.w3.org/2000/svg">
  <!-- プロジェクト名に基づくユニークなアバター -->
</svg>

3. Tech-Pulse 🔥

HackerNewsからトップ5のトレンド技術記事を取得し、AIエージェントがコンテキストを認識できるようにします。

ask run tech-pulse

出力: リンク、スコア、コメント数付きのMarkdown形式の記事。

#1. Breakthrough in AI Reasoning Model
- 🔗 URL: https://news.ycombinator.com/item/...
- 👤 Author: username
- 📈 Score: 1,234 | 💬 Comments: 456

4. The Architect 🏗️

NEW! 説明から新しいスキルを生成します。The Architectは自動的にスターターテンプレートを作成します。

ask run architect "Analyze code complexity"

出力: script.pyとmanifest.yamlを含む完全なスキルディレクトリ。

📦 インストール

オプション1: pipパッケージ - 推奨 (すべての環境で動作)

すべてのユーザー (Windows、Mac、Linux) に最適です。

# GitHubからインストール
pip install git+https://github.com/HughKnightOCE/Agent-Skill-Kit-ASK-.git

# またはホイールファイルからインストール
pip install agent_skill_kit-2.0.0-py3-none-any.whl

# その後、グローバルコマンドを使用
ask dashboard
ask run tech-pulse
ask run repo-visualizer

オプション2: ソースからのインストール - 貢献者に最適

開発者、カスタマイズ、貢献に最適です。

git clone https://github.com/HughKnightOCE/Agent-Skill-Kit-ASK-.git
cd Agent-Skill-Kit-ASK-
pip install -e .

# グローバルコマンドを使用
ask dashboard
ask run architect "Convert CSV to JSON"

オプション3: デスクトップGUI - モダンなインターフェイス

視覚的なユーザー、コマンドライン不要のユーザーに最適です。

# GUIサポート付きでインストール
pip install git+https://github.com/HughKnightOCE/Agent-Skill-Kit-ASK-.git

# 美しいデスクトップアプリケーションを起動
ask-gui

これにより、以下の機能を備えたプロフェッショナルなPyQt6デスクトップアプリケーションが開きます。

• 🎨 モダンで直感的なインターフェイス
• 🔍 スキルブラウザと検索
• 📊 リアルタイム実行ダッシュボード
• 📜 実行履歴追跡
• ⚡ 引数フォーム付きのワンクリックスキル実行

GUIについて詳しく学ぶ →

オプション4: ソースを直接実行 - インストール不要

クイックテスト、試用に最適です。

git clone https://github.com/HughKnightOCE/Agent-Skill-Kit-ASK-.git
cd Agent-Skill-Kit-ASK-

# CLIを介して直接実行
ask dashboard
ask run tech-pulse
ask run architect "Your skill description"

# またはGUIを起動 (PyQt6が必要)
pip install PyQt6
ask-gui

オプション5: スタンドアロン実行可能ファイル - 依存関係ゼロ

Pythonがインストールされていない場合、ポータブルな使用に最適です。 Releasesから事前にビルドされた実行可能ファイルをダウンロードします。

• Windows: ask-gui.exe - ダブルクリックで実行
• macOS: ask-gui - ターミナルから実行
• Linux: ask-gui - ターミナルから実行

Pythonのインストールは不要です！

Windowsコマンドプロンプトのトラブルシューティング

askがコマンドプロンプト (cmd) で機能しない場合は、以下のいずれかの代替手段を使用してください。 オプションA: 代わりにPowerShellを使用する (推奨)

ask dashboard
ask run tech-pulse
ask-gui  # GUIもPowerShellで正常に動作します

オプションB: 直接Pythonを使用する (すべての環境で動作)

python -m core.ask dashboard
python -m core.ask run tech-pulse

オプションC: 手動でScriptsをPATHに追加する

setx PATH "%PATH%;%APPDATA%\Python\Python314\Scripts"

その後、コマンドプロンプトを再起動してaskを再度試してください。

📚 詳細ドキュメント

🎯 哲学: Agent-Native + MCP-Ready

ASKはAIエージェント専用に構築されています。各スキルは以下のような出力を行います。

1. クリーンなMarkdown (AIが読み取り可能な形式)
2. 構造化データ (JSON、YAMLのコメント内)
3. 最小限のノイズ (対話型プロンプトなし)
4. エラーハンドリング (エラー時の適切な対応)

適用例:

• 🤖 Claude Code - ネイティブなスキルアクセスのためのMCP統合
• 🧠 GitHub Copilot CLI - カスタムMCPコマンド
• 🔧 カスタムエージェント - 動的なスキル生成で拡張
• 📡 LLMチェーン - 外部APIなしの多段階ワークフロー
• 🏗️ AIフレームワーク - 任意のエージェント用のMCPサーバーを簡単に導入

🔧 CLIマネージャー: ask (2026エディション)

ASK-2026スタイルとリアルタイム表示を備えた高性能TUIです。

# システムヘルス付きのダッシュボード (NEW!)
ask dashboard

# リアルタイム進捗でスキルを実行
ask run <skill-name> [args...]

# システム診断
ask doctor

# ヘルプ
ask help

機能:

• ✨ ASCIIアートバナー (ASK-2026)
• 📊 システムヘルスダッシュボード (Pythonバージョン、Gitステータス、依存関係)
• 🎬 リアルタイム進捗スピナー
• 🎨 プロフェッショナルな色分け出力

🌐 MCPサーバー統合 (NEW!)

すべてのスキルをネイティブなMCPツールとして公開します。

from core.mcp_gateway import SkillMCPServer

# Claude、Copilot、その他のエージェントはスキルをネイティブツールとして認識します
server = SkillMCPServer()
await server.run()

Claudeは以下のように動作できるようになります。

User: "Use the repo-visualizer tool to analyze my project"
Claude: [invokes repo-visualizer via MCP] → sees complete output

🏗️ The Architect: 新しいスキルを生成 (NEW!)

アイデアを即座にスキルに変えます。

# 自然言語から作成
ask run architect "Convert YAML to JSON"

# 出力:
# ✅ Created: skills/convert-yaml-to-json/
# ✅ Created: script.py
# ✅ Created: manifest.yaml
# 🚀 Next: Edit and run your new skill!

💫 Living README (NEW!)

このREADMEはGitHub Actionsを通じて24時間ごとに自動更新され、トレンド技術情報が反映されます。「Today's Agent Intelligence」セクションは、ASKが以下のことを証明します。

• ✅ 稼働中で機能している
• ✅ 実際のワークフローを実行している
• ✅ 実際のデータに接続されている
• ✅ 本番環境で使用できる

🔧 CLIマネージャー: ask.py

richによって動作するRustにインスパイアされたTUIです。

📁 プロジェクト構造

Agent-Skill-Kit/
├── core/
│   └── ask.py                 # ⭐ メインCLIマネージャー
├── skills/
│   ├── repo-visualizer/
│   │   ├── script.py          # 実装
│   │   └── manifest.yaml      # メタデータ
│   ├── agent-identity/
│   │   ├── script.py
│   │   └── manifest.yaml
│   └── tech-pulse/
│       ├── script.py
│       └── manifest.yaml
├── README.md                  # ここにいます
├── requirements.txt           # 依存関係
└── .github/
    └── workflows/             # CI/CD (オプション)

🛠️ 依存関係

最小限で軽量です。

PyYAML>=6.0        # マニフェスト解析用
rich>=12.0         # 美しいCLI用

インストール:

pip install -r requirements.txt

🤝 貢献: 独自のスキルを追加

ASKはコミュニティの貢献を想定して設計されています。スキルの作成には5分しかかかりません。

スキルテンプレート

各スキルには以下が必要です。

1. script.py - ロジック
2. manifest.yaml - メタデータ

ステップ1: スキルディレクトリを作成

mkdir -p skills/my-awesome-skill
cd skills/my-awesome-skill

ステップ2: script.pyを作成

#!/usr/bin/env python3
"""My awesome skill that does X without any API key."""

def main(arg1, arg2=None):
    """Main execution function."""
    print("🎉 My skill output")
    print("✅ Ready for AI agents!")

if __name__ == "__main__":
    import sys
    arg1 = sys.argv[1] if len(sys.argv) > 1 else "default"
    main(arg1)

ステップ3: manifest.yamlを作成

name: My Awesome Skill
version: "1.0.0"
description: "Does X without requiring any API keys"

author: "Your Name"
category: "utility"

requirements:
  - name: "python"
    version: ">=3.8"

api_keys_required: false
dependencies: []

usage:
  command: "python script.py"
  args_required:
    - name: "arg1"
      description: "Description of argument"

output_format: "markdown"

tags:
  - "keyless"
  - "local"

ステップ4: テスト

python ../core/ask.py dashboard
python ../core/ask.py run my-awesome-skill

ステップ5: PRを提出

私たちは貢献を大歓迎します！以下を含むPRを提出してください。

• ✅ 動作するスキルコード
• ✅ 適切なmanifest.yaml
• ✅ 説明内の使用例
• ✅ 外部APIキー不要

🎁 使用例

個人開発者向け

# 朝の習慣: コーディング中に技術ニュースをチェック
python ask.py run tech-pulse

# ドキュメント用にコードベースを可視化
python ask.py run repo-visualizer

AIエージェント (Claude Code、Copilot CLI) 向け

# エージェントのフロー内で
subprocess.run(["python", "ask.py", "run", "repo-visualizer"])
# Mermaid出力を解析してLLMに渡す

チーム向け

# オンボーディング: プロジェクトの概要を生成
python ask.py run repo-visualizer /monorepo/service-a

# チームのブランディング: 一貫したアバターを作成
python ask.py run agent-identity "TeamName"

🔐 セキュリティとプライバシー

✅ すべての処理はローカルで行われます - API呼び出しを除き、データはマシンを離れません。
✅ 認証は必要ありません - 管理する資格情報はありません。
✅ オープンソース - コードを確認し、ロジックを監査できます。
✅ 最小限の依存関係 - コードが少ない = リスクが少ない。

📊 ロードマップ

• [ ] さらに多くのスキル:
  • code-metrics: コードの複雑さを分析
  • dependency-graph: パッケージの依存関係を可視化
  • api-docs-generator: OpenAPI仕様を自動生成
• [ ] スキルマーケットプレイス: コミュニティのスキルを発見
• [ ] スキルテンプレート: ワンクリックでスキルを生成
• [ ] エージェント統合: 公式のClaude Codeプラグイン
• [ ] パフォーマンス: API呼び出しのキャッシュ層

🐛 トラブルシューティング

"ImportError: No module named 'rich'"

pip install rich pyyaml

"Skill not found"

ask dashboard  # インストールされているスキルを確認

"API call failed"

一部の無料APIにはレート制限があります。数秒後に再度試してください。

📄 ライセンス

MITライセンス - 自由に使用、変更、配布できます。

🌟 サポートを示す

• ⭐ このリポジトリをスター 有用だと思ったら
• 🔗 他のAIツールを開発している開発者と共有
• 📝 コミュニティ用のスキルを貢献
• 💬 機能要求を含む問題を報告

🤖 開発者による、エージェント向け

Agent-Skill-Kitは、AIエージェントがOAuth、APIキー、サインアップの煩わしさなしに強力なローカルツールを持つべきだという信念のもとに構築されています。 個人用の自動化ツールを構築している場合、チームアシスタントを開発している場合、またはClaude Codeと統合している場合、ASKはローカルインテリジェンスへのゼロフリクションなゲートウェイです。

❤️ AIネイティブの未来のために構築されました。

█████████████████████████████████████████████████████
█ Agent-Skill-Kit: Local Power. Zero Keys. Pure Joy. █
█████████████████████████████████████████████████████