Clockify Automation

Clockify Automation skillの概要

Clockify Automationでできること

Clockify Automationは、Rube MCP serverとComposio Clockify toolkitを使い、自然言語でClockifyの時間記録を操作するためのClaude Code skillです。ターミナルからClockify UIへ移動しなくても、時間エントリの作成、過去エントリの検索、ワークスペース文脈の管理、ユーザー確認、チーム活動の監査を行えます。

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

このskillは、すでにClockifyを使っていて、時間入力のワークフローを速くしたい開発者、コンサルタント、制作会社・開発会社、チームリード、運用担当者に向いています。実際の用途は単に「時間を記録する」ことではありません。散らかった作業文脈を、正しいworkspaceId、プロジェクト、タスク、日付、請求可否、タグ、説明文を含む完全なClockify API操作へ変換することです。

汎用プロンプトとの違い

通常のプロンプトでもタイムシート用のメモは作れますが、Clockifyの操作を安定して実行することはできません。Clockify Automation skillが役立つのは、ユーザーの依頼をCLOCKIFY_CREATE_TIME_ENTRYのような具体的なtoolkit actionへ対応づけ、Clockify固有の識別子とISO 8601形式の時刻値を前提に動くからです。この構造により、単なる助言ではなく、再現性のあるWorkflow Automationが必要な場面で曖昧さを減らせます。

導入前に確認したいポイント

Clockifyアカウント、Claude Code、そしてhttps://rube.app/mcpのRube MCP serverへのアクセスが必要です。このskillで確認できるソースファイルはSKILL.mdの1つだけなので導入は軽量ですが、ユーザー側で正確なworkspace、project、task、tag、user IDを用意する必要があります。チームがClockify上の独自ルールに強く依存している場合は、高品質な自動化を期待する前に、そのルールを文書化しておくべきです。

Clockify Automation skillの使い方

Clockify Automationのインストール前提

Clockify Automation skillを使うには、ComposioHQ/awesome-claude-skillsのcomposio-skills/clockify-automationからインストールまたは有効化し、Claude CodeにRube MCP serverのURLであるhttps://rube.app/mcpを設定します。初回利用時には、接続リンクからClockifyアカウントを認証します。上流のskillには補助スクリプトや追加の参照フォルダは含まれていないため、まずSKILL.mdを読み、ツール単位の詳細が必要な場合はhttps://composio.dev/toolkits/clockifyでComposio toolkitのドキュメントを確認してください。

実行前に必要な入力情報

Clockify Automationをうまく使うには、正確なClockify上の文脈が欠かせません。次の情報を用意します。

• 対象ワークスペースのworkspaceId
• エントリを分類する必要がある場合のprojectIdとtaskId
• タイムゾーンを含むISO 8601形式の開始時刻と終了時刻
• 自社のレポート基準に合う説明文
• 必要に応じたtagIds、billable、カスタムフィールド値
• エントリ検索やチーム作業の監査に使うユーザーまたは日付フィルター

弱い依頼例: 「今朝のAPI作業を記録して。」
より良い依頼例: 「Clockify Automationを使って、workspace 64a687e3、project 64a687e2に、2026-02-11T09:00:00Zから2026-02-11T11:00:00Zまでの請求可能なエントリを作成してください。descriptionはAPI development for invoice endpoint、tag IDsは有効であれば["backend","client-work"]を使ってください。」

実務で使いやすいClockify Automationのワークフロー

IDが分からない場合は、まず対象のworkspaceと利用可能なproject文脈を特定するようskillに依頼します。そのうえで、タイムシート全体を自動化する前に、小さな単位でエントリの作成や検索を行います。日常利用では、次の流れが安定します。

1. 重複を避けるため、対象日の既存エントリを検索する。
2. 不足しているエントリを正確な開始・終了タイムスタンプ付きで作成する。
3. 請求可否、project、task、tagを確認する。
4. projectまたはclientごとにまとめたサマリーを依頼する。
5. IDの不一致があれば修正してから、同じ手順を繰り返す。

この流れにより、最もよくある失敗である「もっともらしいエントリを間違ったworkspaceやprojectに記録してしまう」問題を防ぎやすくなります。

出力を改善するプロンプトの型

実行したいClockify操作を明示した、アクション指向のプロンプトを使います。例:

• 「workspace ...で、description Code reviewとして、今から開始するrunning timerを作成して。」
• 「workspace ...のuser ...について、2026-02-01から2026-02-07までのすべてのtime entriesを検索して。」
• 「昨日のチームエントリを監査し、説明文がないもの、請求可能project上の非請求エントリ、8時間を超えるエントリをフラグ付けして。」

このようなプロンプトは、操作内容、範囲、日付、検証基準が含まれているため、漠然とした依頼よりも精度が上がります。

Clockify Automation skillのFAQ

Clockify Automationは初心者にも向いていますか？

はい。ただし、自分のClockify workspace構成を理解していることが前提です。初心者でも時間エントリの記録や検索には使えますが、workspace、project、task、tag IDを見つけるには支援が必要になる場合があります。このskillは、組織がClockifyデータをどう整理しているかを学ぶことの代替にはなりません。

このskillを使わないほうがよい場面は？

文章としてのタイムシート要約だけが必要な場合、Rube MCP経由でClockify認証ができない場合、または時間記録を安全に変更するには依頼が曖昧すぎる場合は、Clockify Automationを使わないでください。請求に関わる慎重なワークフローでは、作成や編集の前に、まずエントリを検索してプレビューするようskillに依頼すると安全です。

ClockifyのWebアプリとは何が違いますか？

ClockifyのWebアプリは、視覚的な確認や手動編集に向いています。Clockify Automation skillは、ターミナル中心の作業、再利用しやすい自然言語操作、時間エントリ全体にまたがる素早い監査に向いています。特に、開発環境にいながらClaude Codeに構造化されたClockify操作を任せたいWorkflow Automationで効果を発揮します。

インストール前に何を読むべきですか？

composio-skills/clockify-automation/SKILL.mdを読んでください。そこにはセットアップ手順、主要ワークフロー、tool call例、workspaceId、start、end、projectId、taskId、tagIds、billable、customFieldValuesなどの重要パラメータが含まれています。skillフォルダ内に追加のローカルスクリプトやリソースはないため、このソースファイルが主な実装ガイドになります。

Clockify Automation skillを改善する方法

Clockify Automationの入力情報を整える

結果を最も早く改善する方法は、Clockify IDの小さな社内リファレンスを維持することです。workspace、projects、tasks、tags、users、custom fieldsをまとめておきます。あわせて、「client workは必ずbillableにする」「supportエントリにはtag supportが必要」といった命名・運用ルールも含めます。そのうえで、関連する部分だけをプロンプトに貼り付ければ、skillが業務ロジックを推測する必要が減ります。

よくある失敗を避ける

タイムゾーンの曖昧さ、終了時刻の抜け、重複エントリ、誤ったworkspace ID、project名の不一致に注意してください。請求に影響する依頼では、まずdry-run風の計画を求めます。「Clockify toolを呼び出す前に、作成予定のエントリをIDとタイムスタンプ付きで一覧にしてください。」この一手間により、自動化を止めずに有効な確認ポイントを追加できます。

最初の出力後に具体的に修正する

最初の検索または作成のあと、具体的な修正で詰めていきます。たとえば、「descriptionにticket API-482を含めてください」「client projectのエントリだけをbillableにしてください」「4時間のエントリをtask別に2時間ずつ2つへ分割してください」といった指示です。全体の目的を言い直すより、skillが返した正確なエントリ情報を参照して修正するほうがうまくいきます。

チームワークフロー向けに強化する

チームで使う場合は、日次記録、週次監査、未入力チェック用のプロンプトテンプレートを標準化します。リポジトリ内に実用的なClockify Automationガイドを置き、承認済みproject ID、必須tag、請求ルール、プロンプト例を含めると効果的です。こうしたローカル文脈があることで、このskillは便利なClockifyショートカットから、信頼できるチーム自動化レイヤーへ変わります。