Agent skill

Secretary

by Shin-sibainu in Shin-sibainu/cc-secretary

パーソナル秘書 & ライフ・ワーク管理システム. An agent skill from Shin-sibainu/cc-secretary.

MITAuto-check passedDocuments & Office

Install Secretary

skills CLI
$ npx skills add Shin-sibainu/cc-secretary --skill secretary -a claude-code

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

GitHub CLI
$ gh skill install Shin-sibainu/cc-secretary secretary --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/Shin-sibainu/cc-secretary.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/secretary/skills/secretary .claude/skills/secretary && 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
secretary
GitHub stars
116
Token cost
~1.3k tokens
SKILL.md length
371 words
Files
3 (incl. references)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

パーソナル秘書 & ライフ・ワーク管理システム. An agent skill from Shin-sibainu/cc-secretary.

  • Works in 5 steps: 検出とモード判定 → オンボーディング(Interactive) → 構成確認(Interactive) → …
  • Documents & Office work in your project
  • SKILL.md covers いつ使うか, 実行モード(ハイブリッド), ワークフロー and 管理モード, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Secretary is an agent skill from Shin-sibainu/cc-secretary. パーソナル秘書 & ライフ・ワーク管理システム。 対話的なオンボーディングであなたの役割・日常・ニーズをヒアリングし、 パーソナライズされたMarkdownフォルダ階層を自動生成する。 セットアップ済みの場合は管理モードに切り替わり、タスク追加やアイデア記録などを行う。

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

It sits in Documents & Office. The repository describes itself as: Claude Code用パーソナル秘書スキル。対話的オンボーディングでMarkdownベースの管理フォルダ階層を自動生成。 The licence is MIT.

When your agent uses it

  • Documents & Office work in your project

Example prompts

  • “/secretary”

Workflow steps

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

  1. 検出とモード判定
  2. オンボーディング(Interactive)
  3. 構成確認(Interactive)
  4. 自動生成(Automatic)
  5. 完了サマリー(Automatic)

What it can do on your machine

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

Secretary loads about 1.3k tokens when it runs, and up to ~4.7k if it reads all its reference files. Until then it costs about 36 tokens; SKILL.md has 371 words of instructions outside code blocks.

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

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 Shin-sibainu/cc-secretary at commit fb734ab, republished under its MIT licence (© Shin-sibainu). 371 words, ~1,342 tokens.

Download SKILL.mdSave it as .claude/skills/secretary/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
secretary
description
パーソナル秘書 & ライフ・ワーク管理システム。 対話的なオンボーディングであなたの役割・日常・ニーズをヒアリングし、 パーソナライズされたMarkdownフォルダ階層を自動生成する。 セットアップ済みの場合は管理モードに切り替わり、タスク追加やアイデア記録などを行う。
trigger
/secretary

パーソナル秘書

いつ使うか

  • 日々のタスクや情報を整理したいとき
  • 新しいプロジェクトで管理体制を構築したいとき
  • 「秘書が欲しい」「整理したい」「TODO管理」「タスク管理」と言われたとき

実行モード(ハイブリッド)

フェーズモード説明
Step 1-3Interactiveヒアリング・構成確認
Step 4-5Automaticフォルダ・ファイル生成
管理モードInteractive日常の操作

ワークフロー

Step 1: 検出とモード判定

対象ディレクトリに .secretary/ が存在するか確認する。

  • .secretary/ が存在する場合: .secretary/CLAUDE.md を読み込み、管理モードへ(下記参照)
  • .secretary/ が存在しない場合: Step 2: オンボーディングへ進む
Step 2: オンボーディング(Interactive)

各サブステップで AskUserQuestion を使う。親しみやすく丁寧に対話する。

Step 2a: 役割・職業

ユーザーの役割をヒアリングする。答えやすいよう例を提示:

あなたの主な役割や職業を教えてください! 例: ソフトウェア開発者、デザイナー、マーケター、学生、フリーランス、研究者、コンテンツクリエイター、マネージャーなど 複数の役割がある場合はまとめて教えてください。

Step 2b: 日々のルーティン

ワークフローパターンを理解するため、典型的な1日を聞く:

あなたの典型的な1日の流れを教えてください。 例: 「午前中はコーディング、午後はミーティング、夕方にレビュー」 あなたに最適な管理構成を作るための参考にします。

Step 2c: 管理したいカテゴリ

利用可能なカテゴリ一覧を提示し、選んでもらう。 inbox と reviews は常に含まれることを伝える。

どの領域を管理したいですか?該当するものを全て選んでください(カスタム追加もOK):

  1. TODO / デイリータスク
  2. アイデア
  3. リサーチ・調査
  4. ナレッジベース
  5. コンテンツ企画(ブログ / YouTube / SNS)
  6. 議事録・ミーティングメモ
  7. クライアント管理
  8. 日記・ジャーナル
  9. 読書リスト
  10. デバッグログ(開発者向け)
  11. プロジェクト管理
  12. 財務・経理

※ inbox(受信箱)と reviews(レビュー)は常に含まれます

番号で回答してください(例: "1,2,3,5")。自由記述もOKです。

Step 2d: 言語設定

秘書システムで使う言語はどれにしますか?

  1. 日本語
  2. English
  3. バイリンガル(両方)
Step 2e: 保存場所

.secretary/ フォルダをどこに作成しますか?

  1. カレントディレクトリ({{CWD}})
  2. ホームディレクトリ(~/)
  3. カスタムパス
Step 3: 構成確認(Interactive)

オンボーディングの回答に基づいて:

  1. ユーザーの役割から推奨フォルダ構成をマッピング(下記 ロール別プリセット 参照)
  2. 明示的に選択されたカテゴリとマージ
  3. 生成予定のフォルダツリーを表示:
.secretary/
├── CLAUDE.md
├── inbox/
│   └── _template.md
├── reviews/
│   └── _template.md
├── todos/
│   ├── _template.md
│   └── {{TODAY}}.md
├── ideas/
│   └── _template.md
├── ... (その他選択されたカテゴリ)
  1. ユーザーに確認。カテゴリの追加・削除・リネームを受け付ける:

以下のフォルダ構成を作成します。いかがですか?

  • OK → 生成を開始
  • 追加 → カテゴリを追加
  • 削除 → カテゴリを削除
  • リネーム → フォルダ名を変更
Step 4: 自動生成(Automatic)

確認後、以下を自動で生成する:

  1. ディレクトリツリーを作成: mkdir -p で全フォルダを作成
  2. _template.md を配置: 各カテゴリフォルダにテンプレートを配置
    • references/templates.md からテンプレートを取得
    • Step 2d の言語設定に応じて日本語版/英語版を選択
  3. .secretary/CLAUDE.md を生成
    • references/claude-md-template.md のテンプレートを使用
    • 全ての {{変数}} にオンボーディングデータを埋め込む
  4. 今日の日次ファイルを作成(todosカテゴリが選択されている場合)
    • デイリーテンプレートに今日の日付を入れて生成
  5. 初回inboxファイルを作成: 今日の日付で生成
Step 5: 完了サマリー(Automatic)

ユーザーに以下を表示:

  1. 作成した全ファイル・フォルダのツリー表示
  2. クイックスタートガイド:

秘書のセットアップが完了しました!使い方:

  • /secretary でいつでも管理システムを起動できます
  • 「タスク追加 [内容]」でタスクを追加
  • 「メモ [内容]」でinboxに素早くメモ
  • 「今日のタスク」で今日のタスクを確認
  • 「ダッシュボード」で全体概要を表示

パーソナライズされた CLAUDE.md が .secretary/CLAUDE.md に作成されました。


管理モード

.secretary/ が既に存在する場合に自動で切り替わる。 まず .secretary/CLAUDE.md を読み込んでユーザーの設定を理解する。

その後 「何をしますか?」 と聞き、以下の操作を受け付ける:

Show full SKILL.md (166 more words)Show less
操作一覧
コマンドパターン動作
"タスク追加 [内容]" / "add todo [text]"今日のTODOファイルを探すか作成し、通常優先度でタスクを追記
"今日のタスク" / "show today"今日の日次ファイルを読み込んで表示。存在しなければテンプレートから作成
"メモ [内容]" / "capture [text]"今日のinboxファイルにタイムスタンプ付きでエントリを追記
"アイデア [タイトル]" / "new idea [title]"テンプレートから ideas/ に新規ファイルを作成し、タイトルを設定
"調査 [タイトル]" / "research [title]"テンプレートから research/ に新規ファイルを作成し、タイトルを設定
"週次レビュー" / "weekly review"今週のデイリーファイルから完了タスクを収集し、reviews/ にレビューファイルを生成
"ダッシュボード" / "dashboard"全カテゴリをスキャンし、件数と最近のアクティビティを表示
"受信箱整理" / "organize inbox"inboxの項目を読み込み、適切なカテゴリへの振り分けを提案。ユーザー承認後に移動
"カテゴリ追加 [名前]" / "add category [name]"汎用 _template.md 付きの新規フォルダを作成し、CLAUDE.mdを更新
ダッシュボード表示形式

「ダッシュボード」リクエスト時の表示:

=== Secretary ダッシュボード ===

TODO(今日): 3件 未完了 / 2件 完了
Inbox: 5件 未整理
アイデア: 12件(今週 3件 追加)
リサーチ: 8件(1件 進行中)
ナレッジ: 15件
最終レビュー: 2026-W10

クイック操作: タスク追加 | メモ | 週次レビュー | 受信箱整理
週次レビュー生成

週次レビュー生成時の手順:

  1. todos/ から今週(月〜日)のファイルをスキャン
  2. [x](完了)と [ ](未完了)のタスクを収集
  3. 週次レビューテンプレートでレビューファイルを作成
  4. 完了タスクを記入し、未完了タスクを持ち越しに記載
  5. ユーザーに振り返りの記入を促す

ロール別プリセット

ユーザーの役割が特定できた場合、以下のデフォルトカテゴリセットを提案する:

ソフトウェア開発者
  • todos, projects, ideas, knowledge(サブフォルダ: languages, frameworks), debugging
  • おすすめ追加: research, reading-list
コンテンツクリエイター
  • todos, content-plan(サブフォルダ: blog, youtube, social), ideas, research
  • おすすめ追加: analytics, reading-list
学生・研究者
  • todos, courses, research(サブフォルダ: papers, notes), knowledge, reading-list
  • おすすめ追加: ideas, journal
フリーランス
  • todos, clients, projects, ideas, research(サブフォルダ: market, competitors)
  • おすすめ追加: finances, meetings
デザイナー
  • todos, projects, ideas, research(サブフォルダ: inspiration, competitors), knowledge
  • おすすめ追加: clients, content-plan
マネージャー
  • todos, meetings, projects, knowledge
  • おすすめ追加: clients, research
その他・汎用
  • todos, ideas, knowledge
  • おすすめ追加: research, journal, reading-list

ファイル参照

  • カテゴリテンプレート: references/templates.md
  • CLAUDE.md 生成テンプレート: references/claude-md-template.md

重要な注意事項

  • インタラクティブなステップでは必ず AskUserQuestion を使い、勝手に推測しない
  • ユーザーの言語選択を生成コンテンツ全体で一貫して適用する
  • inbox/ と reviews/ は選択に関わらず常に含める
  • 管理モードでは必ず最初に .secretary/CLAUDE.md を読み込む
  • 既存ファイルは上書きしない。追記または新規作成のみ
  • ファイル名はkebab-case、日付ベースのファイルは YYYY-MM-DD
  • テンプレートの {{変数}} プレースホルダは生成時に実際の値に置換すること

© Shin-sibainu, 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 plugins/secretary/skills/secretary of Shin-sibainu/cc-secretary.

  • SKILL.md
  • references/claude-md-template.md
  • references/templates.md

Open the folder on GitHubat commit fb734ab

Compare with similar skills

Secretary 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.

Secretary compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Secretary this skillShin-sibainu/cc-secretary116—~1.3kAutomated safety check: PassMIT
Markdown Article FormatterJimLiu/baoyu-skills27k6 repos~3.5kAutomated safety check: PassMIT
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
Obsidian MarkdownAtmosphere/atmosphere3.8k20 repos~1.3kAutomated safety check: PassApache-2.0
DOCXrvdbreemen/OTGW-firmware20733 repos~4.3kAutomated safety check: PassProprietary
Word Document Reader and WriterHKUDS/DeepTutor41k—~2.5kAutomated safety check: PassApache-2.0

Similar skills

  • Markdown Article Formatter

    JimLiu/baoyu-skills

    Reformats plain text or Markdown articles with frontmatter, a title, a summary, headings, bold, lists and code blocks, and saves a separate formatted copy.

    27k GitHub starsUsed in 6 repos~3.5k tokens
    Documents & OfficeAuto-check passed
  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • Obsidian Markdown

    Atmosphere/atmosphere

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    3.8k GitHub starsUsed in 20 repos~1.3k tokens
    Documents & OfficeAuto-check passed
  • DOCX

    rvdbreemen/OTGW-firmware

    A skill your agent uses whenever the user wants to create, read, edit, or manipulate Word documents (.docx files).

    207 GitHub starsUsed in 33 repos~4.3k tokens
    Documents & OfficeAuto-check passed
  • Reads, creates and edits Word .docx files with python-docx, and drops to raw OOXML for tracked changes, comments and byte-exact edits.

    41k GitHub stars~2.5k tokensUpdated 3 days ago
    Documents & OfficeAuto-check passed
  • Crossposting

    wasp-lang/wasp

    Crosspost Wasp blog articles (MDX) to DEV.to and Medium. An agent skill from wasp-lang/wasp.

    19k GitHub stars~1.1k tokensUpdated today
    Documents & OfficeAuto-check passed

Questions about Secretary

What does Secretary do?

パーソナル秘書 & ライフ・ワーク管理システム. An agent skill from Shin-sibainu/cc-secretary. Secretary is an agent skill from Shin-sibainu/cc-secretary.

When should I use Secretary?

Secretary fits situations like: documents & Office work in your project.

How do I install Secretary in Claude Code?

Run `npx skills add Shin-sibainu/cc-secretary --skill secretary -a claude-code`. Or copy the skill folder (plugins/secretary/skills/secretary in Shin-sibainu/cc-secretary) into .claude/skills/secretary in your project. Claude Code loads it when a task matches its description.

How do I install Secretary in Codex?

Run `npx skills add Shin-sibainu/cc-secretary --skill secretary -a codex`. Or copy the skill folder (plugins/secretary/skills/secretary in Shin-sibainu/cc-secretary) into .agents/skills/secretary in your project. Codex loads it when a task matches its description.

Can I use Secretary 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 Shin-sibainu/cc-secretary --skill secretary -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/secretary, .gemini/skills/secretary, .github/skills/secretary and .opencode/skills/secretary in your project.

What does Secretary need to run?

SKILL.md names no scripts, command-line tools or credentials: Secretary is instructions for the agent only.

Does Secretary 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 Secretary 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 Secretary use?

Secretary 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 Secretary use?

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

What are the alternatives to Secretary?

Skills that share tags, products or a category with Secretary: Markdown Article Formatter (JimLiu/baoyu-skills, 27k stars), Markitdown (ImCa0/just-laws, 781 stars), Obsidian Markdown (Atmosphere/atmosphere, 3.8k stars) and DOCX (rvdbreemen/OTGW-firmware, 207 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Secretary?

Shin-sibainu (a GitHub user) maintains it in Shin-sibainu/cc-secretary, which has 116 GitHub stars. The repository was last updated on March 7, 2026.

Source: Shin-sibainu/cc-secretary on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.