timely-automation

timely-automation skill の概要

timely-automation でできること

timely-automation は、Composio の Rube MCP server を通じて Timely の操作を自動化するための Claude skill です。価値の中心は、固定された Timely 用スクリプトではありません。エージェントに RUBE_SEARCH_TOOLS で最新の Timely tool schema を見つけさせ、Timely の接続状態を確認したうえで、タスクに合った Rube MCP tool を実行させる点にあります。

ツール名、必須フィールド、API schema が変わる可能性のある操作で、推測に頼らず AI アシスタントに Timely workflow automation を任せたい場合に向いています。

向いているユーザーと用途

timely-automation skill は、すでに Timely を使っていて、利用可能な Timely action の探索、tool call の準備、接続状態の確認、Composio 経由の対応 workflow 実行といった運用タスクを Claude に手伝わせたいユーザーに適しています。手作業の time-tracking 管理よりも、tool-driven な自動化を好むチームで特に役立ちます。

一方で、time tracking に関する自然言語のアドバイスだけが必要な場合、Timely を使っていない場合、または利用中の AI client で Rube MCP に接続できない場合には、あまり有用ではありません。

主な違い: 先に schema を発見する

この timely-automation guide で最も重要なのは、「まず tools を検索する」というルールです。静的な API contract を前提にするのではなく、実行前に RUBE_SEARCH_TOOLS を使うことを求めます。Composio tool schema は変わる可能性があり、古い prompt のままだと、気づかないうちに失敗したり、不完全なフィールドを送ったりするためです。

実務上の流れは、tools を発見する、timely connection を確認する、必須入力を確認する、実行する、結果をレビューする、という順番です。

導入前に確認したいこと

timely-automation をインストールする前に、利用中の client が MCP に対応しており、https://rube.app/mcp を server として追加できることを確認してください。元の skill は SKILL.md のみで構成されており、補助 script や local resource はありません。そのため導入の成否は、repository 側の utility ではなく、MCP の設定、Timely の認可、prompt の質に左右されます。

timely-automation skill の使い方

timely-automation のインストール前提

GitHub skill repository から、次のコマンドで skill をインストールします。

npx skills add ComposioHQ/awesome-claude-skills --skill timely-automation

次に、AI client に Rube MCP を追加して設定します。

https://rube.app/mcp

元の skill では、MCP endpoint に別途 API key は不要とされています。ただし、有効な Timely connection は必要です。実際の運用では、Timely の作業を始める前に、RUBE_SEARCH_TOOLS が利用できるかエージェントに確認させるのが安全です。

workflow 実行前に必要なセットアップ

信頼できる timely-automation の利用フローは、connection validation から始めます。

1. RUBE_SEARCH_TOOLS が応答することを確認する。
2. toolkit timely を指定して RUBE_MANAGE_CONNECTIONS を使う。
3. connection が ACTIVE でない場合は、返された authorization link に従う。
4. Timely action の実行をエージェントに依頼する前に、もう一度 status を確認する。

この手順は省略しないでください。一見すると「AI の失敗」に見える問題の多くは、実際には app connection が inactive だったり、schema field が不足していたりすることが原因です。

大まかな目的を実行しやすい prompt に変える

弱い prompt:

Update my Timely stuff.

より良い prompt:

Use the timely-automation skill. First call RUBE_SEARCH_TOOLS for the exact Timely task: “find supported operations for managing Timely entries and projects.” Check the timely connection with RUBE_MANAGE_CONNECTIONS. If active, show me the available tool options, required fields, and any risks before executing. Do not run a write action until I approve the prepared tool call.

このように書くと、skill 名を明示し、schema discovery を強制し、read action と write action を分け、実行前レビューを求められるため、より安定して動きます。

最初に読むべきファイル

まず composio-skills/timely-automation/SKILL.md を確認してください。ここに prerequisites、setup、tool discovery、中心となる workflow pattern まで、運用上の contract がすべて含まれています。この skill path には README.md、metadata.json、rules/、resources/、scripts/ はないため、主要ファイルである SKILL.md が信頼できる情報源です。

tool-specific な挙動については、例から推測するのではなく、リンクされている Composio Timely toolkit documentation と、実行時の RUBE_SEARCH_TOOLS の出力を使って確認してください。

timely-automation skill FAQ

timely-automation は Workflow Automation 用ですか、それとも reporting 用ですか？

timely-automation skill は、主に Timely の Composio toolkit を通じた Workflow Automation 用です。reporting に近いタスクを支援できる tool が見つかる場合もありますが、確実に扱える範囲は、接続済みの Timely account に対して実行時に RUBE_SEARCH_TOOLS が返す内容に限られます。

普通の prompt より何が良いのですか？

普通の prompt では、Timely API field を作り上げてしまったり、古い前提に頼ってしまったりすることがあります。timely-automation は、まず Rube MCP に現在の tool schema を問い合わせるようエージェントに指示するため、workflow がより現実の schema に沿ったものになり、実行時の安全性も高まります。

初心者でも使えますか？

はい。MCP を設定でき、Timely connection のフローを完了できるなら使えます。初心者は、実行前に発見された各 tool の説明と必須フィールドをエージェントに表示させるとよいでしょう。tool call の承認に不安がある場合は、まず read-only の discovery task から始めてください。

timely-automation を使わない方がよい場面は？

Timely connection が inactive の場合、client が Rube MCP にアクセスできない場合、またはタスクが Timely 側でサポートされていない挙動を必要とする場合は使わないでください。また、「clean up my account」のような曖昧な write request に対して、明確な制約や変更前の承認を求めずに使うのも避けるべきです。

timely-automation skill を改善する方法

タスク詳細で timely-automation の prompt を改善する

入力が具体的であるほど、tool selection の精度は上がります。次の情報を含めてください。

• 対象にしたい Timely object。例: time entries、projects、users、clients、tags
• タスクが read-only なのか、data を変更してよいのか
• date range、project name、user name、filter
• write action 前の approval requirements
• summary、table、prepared tool call など、希望する output format

これにより、不要な discovery を減らし、目的に合った Composio tool へエージェントが対応づけやすくなります。

よくある失敗を防ぐ

よくある問題は、Timely authorization が inactive、tool discovery の省略、必須フィールドの不足、範囲が広すぎる write request です。防ぐには、エージェントに次の手順を必ず求めてください。

1. specific use case に対して tools を検索する。
2. timely connection を確認する。
3. 選択した tool slug と schema を提示する。
4. 不足している field を質問する。
5. 破壊的または大規模な変更の前に approval を求める。

最初の出力後に反復する

最初の discovery response の後は、最初からやり直すのではなく、workflow を絞り込んでください。例:

Use the same Rube session. Narrow the Timely tool search to updating time entries for last week. Compare the required fields across candidate tools and recommend the safest one before execution.

これにより context を保ち、setup の繰り返しを減らし、判断の質を高められます。

必要に応じて local operating rules を追加する

チームが Timely を特定の運用ルールで使っている場合は、local prompt や project instructions に、「never modify locked periods」「always filter by workspace」「summarize before executing bulk changes」のようなルールを追加してください。upstream の timely-automation skill は意図的に軽量に作られているため、core の discovery-first pattern を変えずに workflow へ適応させるには、local guardrails を追加するのが最も適しています。