mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-19 02:17:09 +00:00
docs(hub): describe the current Hubs page flow
The hub-index guide and the ui reference still described the old Browse / My hubs tabs with New Hub, Save draft and Download index, and an in-dialog Hub manager, none of which exist anymore. Readers following them could not find the controls. Rewrite the Web Dashboard section in all five locales around Add or create a Hub, Add skill, Save, Share -> Download skillshare-hub.json and the hub add command, using each locale's dashboard labels. Drop the stale hub-builder-draft.png screenshot, which shows the removed UI.
This commit is contained in:
@@ -140,42 +140,38 @@ When a GitHub/GHE hub is loaded over SSH, same-host domain-prefixed skill source
|
||||
|
||||
### Create a Hub without writing JSON
|
||||
|
||||
Open **Skills → Hubs → My hubs → New Hub** in the dashboard (`skillshare ui`).
|
||||
Open **Skills → Hubs** in the dashboard (`skillshare ui`), then choose **Add or create a Hub → Create a new Hub**. The new Hub opens for editing.
|
||||
|
||||
1. Give the draft a name and optional description. These identify the draft locally; they are not included in the exported index.
|
||||
2. Choose **Choose installed skills**, select the skills to share, and add them. Or use **Add source manually**.
|
||||
3. Edit each skill's display name, description, tags, and install source. For example, `runkids/demo-skills/skills/pdf` identifies a skill inside a remote repository. The **Advanced** section preserves an optional `skill` selector for repositories containing multiple skills.
|
||||
4. Choose **Save draft**. The page checks every entry and displays any export blockers.
|
||||
5. Choose **Download index** to obtain `skillshare-hub.json`.
|
||||
6. Commit the downloaded file to your own Git repository or upload it to an HTTP server. Enter that location in the page to copy a `skillshare hub add` command for recipients.
|
||||
|
||||
In this draft, one skill has only a local source, so export is blocked until it gets a remote source:
|
||||
|
||||

|
||||
1. Give the Hub a **Name** and optional **Description**. The name becomes the `--label` of the `skillshare hub add` command you share; neither is included in the exported index.
|
||||
2. Choose **Add skill**. On **Paste URL**, enter a **Git URL**, choose **Find**, pick a **Version**, and select the skills to add. On **Installed**, select skills installed on this machine. Or choose **Can’t find it? Enter the source yourself** to add an empty row.
|
||||
3. Edit each skill's **Name**, **Source**, and **Version**. For example, `runkids/demo-skills/skills/pdf` identifies a skill inside a remote repository. Expand a row for **Skill description**, **Tags (comma-separated)**, and **Skill selector (optional)**, which selects a skill in a repository containing multiple skills.
|
||||
4. Choose **Save**. The page checks every entry. If a skill cannot be installed by others, the editor stays open and marks that row.
|
||||
5. Choose **Share → Download skillshare-hub.json**. The download is disabled until the marked skills are fixed with **Edit**.
|
||||
6. Commit the downloaded file to your own Git repository or upload it to an HTTP server. Paste that URL in the **Share** dialog to copy a `skillshare hub add` command for recipients. The URL is saved with the Hub.
|
||||
|
||||
Downloading does **not** publish anything. The catalog references skills; it does not bundle their files. Source validation checks syntax, not whether a repository exists or whether recipients have permission. Private repositories still require access.
|
||||
|
||||
:::tip Local skills can stay in drafts
|
||||
An installed skill with no known remote origin remains visible with its local source. You can save it in a draft. Export is blocked until you provide a remote install source or remove that entry; the builder never silently leaves it out.
|
||||
:::tip Local skills can stay in your Hub
|
||||
An installed skill with no known remote origin keeps its local source. You can save it in your Hub. The download is blocked until you provide a remote install source or remove that entry; the builder never silently leaves it out.
|
||||
:::
|
||||
|
||||
### Resume or import a catalog
|
||||
|
||||
Drafts are stored on the machine running the dashboard in `hub-drafts/` next to the active configuration file. Global and project configurations have separate drafts. Use **Save draft** before reloading. Leaving with unsaved changes prompts you to discard them; saves from an outdated window are rejected so they cannot overwrite a newer revision. **Reload saved draft** retrieves the latest version.
|
||||
Your own Hubs are marked **Mine** in the Hub list. They are stored on the machine running the dashboard in `hub-drafts/` next to the active configuration file. Global and project configurations have separate Hubs. Choose **Save** before reloading. While you edit, the Hub list is locked; leaving with unsaved changes prompts you to discard them. Saves from an outdated window are rejected so they cannot overwrite a newer revision. **Cancel** reloads the latest saved version.
|
||||
|
||||
Use **Import JSON** for an existing v1 `skillshare-hub.json` (up to 4 MB). Unsupported versions and invalid field types produce errors. Entries with the same display name remain separate. Extra JSON fields and `skill` selectors are preserved. If an older index includes `sourcePath`, relative sources are resolved as local paths, matching the existing index reader; they must be changed to remote sources before export.
|
||||
Use **Add or create a Hub → Import skillshare-hub.json** for an existing v1 `skillshare-hub.json` (up to 4 MB). Unsupported versions and invalid field types produce errors. Entries with the same display name remain separate. Extra JSON fields and `skill` selectors are preserved. If an older index includes `sourcePath`, relative sources are resolved as local paths, matching the existing index reader; they must be changed to remote sources before export.
|
||||
|
||||
The portable export removes the author's `sourcePath` and known local metadata (`relPath`, `flatName`, `installedAt`, `isInRepo`). It contains the index, not the draft's name, description, IDs, or revisions. Changing an entry's source or skill selector clears its previous audit score, label, and timestamp. URL credentials, query strings, and fragments are rejected; configure repository authentication separately.
|
||||
The portable export removes the author's `sourcePath` and known local metadata (`relPath`, `flatName`, `installedAt`, `isInRepo`). It contains the index, not the Hub's name, description, IDs, revisions, or hosting URL. Changing an entry's source or skill selector clears its previous audit score, label, and timestamp. URL credentials, query strings, and fragments are rejected; configure repository authentication separately.
|
||||
|
||||
**Delete draft** asks for confirmation and deletes only that draft. It does not uninstall skills, delete a hosted index, or remove a subscribed Hub.
|
||||
**More actions → Delete Hub** asks for confirmation and deletes only that Hub. It does not uninstall skills, delete a hosted index, or remove a subscribed Hub.
|
||||
|
||||
### Search a shared Hub
|
||||
|
||||
1. Open **Skills → Install**.
|
||||
2. Choose a Hub from the search source selector. Use the Hub manager in the install dialog to add a URL, SSH repository, or local index path.
|
||||
1. Open **Skills → Install** and choose **Search**.
|
||||
2. Choose a Hub in the **In** selector. To add a URL, SSH repository, or local index path, choose **Manage hubs** next to the selector, then **Add or create a Hub → Add an existing Hub** on the Hubs page.
|
||||
3. Search, preview, and install skills.
|
||||
|
||||
Subscribed Hub sources are saved in the active skillshare configuration and shared with the CLI. They are separate from the drafts in **My hubs**.
|
||||
You can also pick a Hub on the Hubs page to filter its skills and install them. Subscribed Hub sources are saved in the active skillshare configuration and shared with the CLI. They are separate from your own Hubs.
|
||||
|
||||
The existing `skillshare hub index` command and `/api/hub/index` endpoint continue to generate indexes as before, including support for local sources. The portable-export rules above apply to the dashboard builder.
|
||||
|
||||
|
||||
@@ -89,7 +89,7 @@ Some pages show a count in the sidebar when they need attention. The counts refr
|
||||
| **Dashboard** | Counts for skills, agents, extras, MCP servers, plugins, and targets, plus items that need attention |
|
||||
| **Sync** | Preview every change per target before writing. Choose which parts to include (Skills, Agents, Extras, MCP). Files edited inside a target are kept unless **Force** is on. Items that exist only in a target can be collected back to source from here. Each sync backs up target folders first. When a target fails, the others still sync: the page lists each failed target with its part (Skills, Agents, Extras or Config), a plain-language explanation when the cause is a common one (a symlink that points elsewhere, permission denied, a read-only file system, a missing file or folder, invalid target settings) and the error, above the other warnings, offers **Turn on Force** for a skills symlink that points elsewhere, and marks the target in the change list. Even when every target fails, the page lists them the same way. The **Last sync** card names the targets that failed in the latest sync |
|
||||
| **Git Sync** | Commit and push the source repo, push commits that aren't on the remote yet, and pull. Opening the page fetches from the remote, so **Pull** shows how many commits the remote has. Pull syncs what the repo scope holds (`skills`, `agents`, `extras`, or `root`), like [`pull`](/docs/reference/commands/pull). When the remote rejects a push because it has newer commits, the error offers **Pull**. When a first pull can't merge with the remote, it offers a force pull that replaces local files with the remote branch |
|
||||
| **Hubs** | Reached from the Skills page. **Browse** filters a hub and installs from it; **My hubs** assembles an index from installed skills, validates it and exports it. See [`hub`](/docs/reference/commands/hub) |
|
||||
| **Hubs** | Reached from the Skills page. Lists the built-in hub, saved hubs, and your own Hubs (**Mine**); pick one to filter its skills and install them. **Add or create a Hub** adds an existing hub, creates a new Hub, or imports a `skillshare-hub.json`. Your own Hubs are changed with **Edit**; **Share** downloads the index and builds the `hub add` command. See [`hub`](/docs/reference/commands/hub) |
|
||||
| **Skills** / **Agents** | Installed items, the **Updates** tab, and the **Trash** tab. Skills also have an **Analyze** tab that estimates how many tokens each skill adds to a target's context. **Install** searches GitHub or installs from a URL or path. **+ New Skill** opens the creation wizard. The list and card views can filter by **Folder** (a tracked repo, a folder such as `frontend/react`, or **Root**) and group by **Folder**, with the root first and folders A→Z. The **tree** view shows the source folders on the left and details on the right: click a folder or skill to select it, Cmd/Ctrl-click to add to the selection, Shift-click for a range, and double-click a skill to open it. The right side turns everything selected on or off with one switch, sets its targets (tracked repos and their subfolders included), and lists each skill with its own switch; a tracked repo also offers **Update repo** and **Uninstall repo**. A skill with `disable-model-invocation: true` carries a **manual only** tag in the list, on its tile and on its detail page, the same state [`list`](/docs/reference/commands/list) toggles with `M`. In the skill editor, **Add field** describes what each frontmatter field does. **Sync skills** / **Sync agents** previews, then syncs only that kind to every target; the same dialog opens from **Sync Now** after an update, an uninstall or a collect |
|
||||
| **Extras** | **Folders**: rules, commands, and other folders synced alongside skills. **AGENTS.md**: in global mode, shared `AGENTS.md` files and which targets use them; in a project, the project's `./AGENTS.md` and whether each target reads it. See [Share one AGENTS.md across your tools](../../how-to/daily-tasks/sharing-instructions.md) |
|
||||
| **MCP** | One row per server, with the Agents it syncs to as chips; the count button on the row opens their toggles. **Add server** takes a URL, a command, a pasted snippet or a file; **Import from a target** reads what an installed Agent already has. Each server's menu has **View what each Agent gets**, which lists the source and every Agent's file and shows the one you pick, including unsaved edits. Conflicts offer **Import from** the Agent or **Replace with source**. For a Pi server, the server dialog chooses the [Pi MCP mode](./mcp.md#pi-choose-your-mcp-extension), built-in by default, and its tool exposure and other Pi settings, which take [`piOptions`](./mcp.md#pi-options) as JSON. **Defaults** edits `mcp.targets` and `mcp.directTools`. **Sync MCP**, in the Sync box, lists the pending changes and writes only the MCP config files, keeping a backup of each; below it, [**Check**](./mcp.md#check-servers-before-an-agent-starts-them) checks the servers and **Backups and restore** previews and restores those backups. |
|
||||
|
||||
+41
-41
@@ -153,69 +153,69 @@ SSH 経由でインストールできます。Hub が HTTP、ローカルファ
|
||||
|
||||
### JSON を書かずに Hub を作成する
|
||||
|
||||
ダッシュボード(`skillshare ui`)で **Skills → Hubs → My hubs → New Hub** を開きます。
|
||||
ダッシュボード(`skillshare ui`)で **スキル → Hub** を開き、**Hub を追加・作成 → 新しい Hub を作成** を選びます。新しい Hub はそのまま編集状態で開きます。
|
||||
|
||||
1. ドラフトに名前と任意の説明を付けます。これらはローカルでドラフトを識別するためのもので、
|
||||
エクスポートされたインデックスには含まれません。
|
||||
2. **Choose installed skills** を選び、共有する Skill を選択して追加します。または
|
||||
**Add source manually** を使います。
|
||||
3. 各 Skill の表示名、説明、タグ、インストール Source を編集します。例えば、
|
||||
`runkids/demo-skills/skills/pdf` はリモートリポジトリ内の Skill を識別します。
|
||||
**Advanced** セクションでは、複数の Skill を含むリポジトリ用の任意の `skill` セレクターを
|
||||
保持します。
|
||||
4. **Save draft** を選びます。ページはすべてのエントリをチェックし、エクスポートを妨げるものが
|
||||
あれば表示します。
|
||||
5. `skillshare-hub.json` を取得するには **Download index** を選びます。
|
||||
1. Hub に **名前** と任意の **説明** を付けます。名前は共有する `skillshare hub add` コマンドの
|
||||
`--label` になります。どちらもエクスポートされたインデックスには含まれません。
|
||||
2. **skill を追加** を選びます。**URL を貼り付け** タブでは **Git URL** を入力して **探す** を選び、
|
||||
**バージョン** を選んでから追加する Skill を選択します。**インストール済み** タブでは、このマシンに
|
||||
インストール済みの Skill を選択します。または **見つからない場合はソースを手入力** を選んで空の行を
|
||||
追加します。
|
||||
3. 各 Skill の **名前**、**ソース**、**バージョン** を編集します。例えば、
|
||||
`runkids/demo-skills/skills/pdf` はリモートリポジトリ内の Skill を識別します。行を展開すると
|
||||
**スキルの説明**、**タグ(カンマ区切り)**、**スキルセレクター(任意)** を編集できます。
|
||||
スキルセレクターは、複数の Skill を含むリポジトリ内の Skill を選択します。
|
||||
4. **保存** を選びます。ページはすべてのエントリをチェックします。他の人がインストールできない Skill が
|
||||
あれば、エディターは開いたままその行に印を付けます。
|
||||
5. **共有 → skillshare-hub.json をダウンロード** を選びます。印の付いた Skill を **編集** で直すまで、
|
||||
ダウンロードはできません。
|
||||
6. ダウンロードしたファイルを自分の Git リポジトリにコミットするか、HTTP サーバーにアップロード
|
||||
します。受け取り側のための `skillshare hub add` コマンドをコピーするには、そのロケーションを
|
||||
ページに入力します。
|
||||
|
||||
次のドラフトでは 1 つの Skill の Source がローカルのみのため、リモートの Source を指定するまでエクスポートできません。
|
||||
|
||||

|
||||
します。**共有** ダイアログにその URL を貼り付けると、受け取り側のための `skillshare hub add`
|
||||
コマンドをコピーできます。URL は Hub と一緒に保存されます。
|
||||
|
||||
ダウンロードは何も公開する**わけではありません**。カタログは Skill を参照するだけで、そのファイルを
|
||||
バンドルするわけではありません。Source の検証は構文をチェックするだけで、リポジトリが存在するか、
|
||||
受け取り側に権限があるかは確認しません。プライベートリポジトリには引き続きアクセス権が必要です。
|
||||
|
||||
:::tip ローカルの Skill もドラフトに残せる
|
||||
既知のリモート由来を持たないインストール済みの Skill も、そのローカル Source と共に表示され続けます。
|
||||
それをドラフトに保存できます。リモートのインストール Source を指定するかそのエントリを削除するまで
|
||||
エクスポートはブロックされます。ビルダーがそれを黙って除外することはありません。
|
||||
:::tip ローカルの Skill も Hub に残せる
|
||||
既知のリモート由来を持たないインストール済みの Skill は、そのローカル Source を保持します。
|
||||
それを Hub に保存できます。リモートのインストール Source を指定するかそのエントリを削除するまで
|
||||
ダウンロードはブロックされます。ビルダーがそれを黙って除外することはありません。
|
||||
:::
|
||||
|
||||
### カタログを再開またはインポートする
|
||||
|
||||
ドラフトは、ダッシュボードを実行しているマシン上の、有効な設定ファイルの隣にある `hub-drafts/` に
|
||||
保存されます。Global と Project の設定は別々のドラフトを持ちます。再読み込みする前に **Save draft**
|
||||
を使ってください。未保存の変更を残したまま離れると破棄するか確認されます。古くなったウィンドウからの
|
||||
保存は拒否されるため、より新しいリビジョンを上書きすることはできません。**Reload saved draft** は
|
||||
最新版を取得します。
|
||||
自分の Hub は Hub 一覧で **自分の** と表示されます。これらはダッシュボードを実行しているマシン上の、
|
||||
有効な設定ファイルの隣にある `hub-drafts/` に保存されます。Global と Project の設定は別々の Hub を
|
||||
持ちます。再読み込みする前に **保存** を選んでください。編集中は Hub 一覧がロックされ、未保存の変更を
|
||||
残したまま離れると破棄するか確認されます。古くなったウィンドウからの保存は拒否されるため、より新しい
|
||||
リビジョンを上書きすることはできません。**キャンセル** は最後に保存された版を読み込み直します。
|
||||
|
||||
既存の v1 `skillshare-hub.json`(4 MB まで)には **Import JSON** を使います。非対応のバージョンや
|
||||
無効なフィールド型はエラーになります。同じ表示名を持つエントリは別々のまま残ります。追加の JSON
|
||||
フィールドや `skill` セレクターは保持されます。古いインデックスに `sourcePath` が含まれる場合、
|
||||
相対 Source は既存のインデックスリーダーと同様にローカルパスとして解決されます。エクスポート前に
|
||||
リモート Source に変更する必要があります。
|
||||
既存の v1 `skillshare-hub.json`(4 MB まで)には **Hub を追加・作成 → skillshare-hub.json を読み込む**
|
||||
を使います。非対応のバージョンや無効なフィールド型はエラーになります。同じ表示名を持つエントリは
|
||||
別々のまま残ります。追加の JSON フィールドや `skill` セレクターは保持されます。古いインデックスに
|
||||
`sourcePath` が含まれる場合、相対 Source は既存のインデックスリーダーと同様にローカルパスとして
|
||||
解決されます。エクスポート前にリモート Source に変更する必要があります。
|
||||
|
||||
ポータブルなエクスポートは、作者の `sourcePath` と既知のローカルメタデータ(`relPath`、`flatName`、
|
||||
`installedAt`、`isInRepo`)を取り除きます。それにはインデックスが含まれ、ドラフトの名前、説明、
|
||||
ID、リビジョンは含まれません。エントリの Source や skill セレクターを変更すると、その前の監査
|
||||
スコア、ラベル、タイムスタンプはクリアされます。URL の認証情報、クエリ文字列、フラグメントは
|
||||
`installedAt`、`isInRepo`)を取り除きます。それにはインデックスが含まれ、Hub の名前、説明、
|
||||
ID、リビジョン、公開先 URL は含まれません。エントリの Source や skill セレクターを変更すると、その前の
|
||||
監査スコア、ラベル、タイムスタンプはクリアされます。URL の認証情報、クエリ文字列、フラグメントは
|
||||
拒否されます。リポジトリの認証は別途設定してください。
|
||||
|
||||
**Delete draft** は確認を求め、そのドラフトのみを削除します。Skill をアンインストールしたり、
|
||||
**その他の操作 → Hub を削除** は確認を求め、その Hub のみを削除します。Skill をアンインストールしたり、
|
||||
ホストされているインデックスを削除したり、サブスクライブ済みの Hub を削除したりすることはありません。
|
||||
|
||||
### 共有された Hub を検索する
|
||||
|
||||
1. **Skills → Install** を開きます。
|
||||
2. 検索 Source セレクターから Hub を選びます。install ダイアログの Hub マネージャーを使って、
|
||||
URL、SSH リポジトリ、またはローカルのインデックスパスを追加できます。
|
||||
1. **スキル → インストール** を開き、**検索** を選びます。
|
||||
2. **検索先** セレクターで Hub を選びます。URL、SSH リポジトリ、またはローカルのインデックスパスを
|
||||
追加するには、セレクターの横の **ハブを管理** を選び、Hub ページで
|
||||
**Hub を追加・作成 → 既存の Hub を追加** を選びます。
|
||||
3. Skill を検索、プレビュー、インストールします。
|
||||
|
||||
サブスクライブ済みの Hub Source は有効な skillshare 設定に保存され、CLI と共有されます。これらは
|
||||
**My hubs** のドラフトとは別物です。
|
||||
Hub ページで Hub を選び、その Skill を絞り込んでインストールすることもできます。サブスクライブ済みの
|
||||
Hub Source は有効な skillshare 設定に保存され、CLI と共有されます。これらは自分の Hub とは別物です。
|
||||
|
||||
既存の `skillshare hub index` コマンドと `/api/hub/index` エンドポイントは、ローカル Source の
|
||||
対応を含め、これまで通りインデックスを生成し続けます。上記のポータブルエクスポートのルールは
|
||||
|
||||
@@ -89,7 +89,7 @@ skillshare ui start --clear-cache
|
||||
| **Dashboard** | Skill、Agent、Extras、MCP サーバー、Plugin、Target の件数、および対応が必要な項目 |
|
||||
| **Sync** | 書き込む前に、Target ごとにすべての変更をプレビュー。含める項目を選択(Skills、Agents、Extras、MCP)。Target 内で編集されたファイルは、**Force** がオンでない限り保持される。Target にのみ存在する項目は、ここから Source に collect し戻せる。各 sync は最初に Target フォルダをバックアップする。Target が失敗しても他の Target は sync される。失敗した Target は、その部分(Skills、Agents、Extras、Config)とエラーとともに他の警告より上に一覧表示され、よくある原因(別の場所を指す symlink、権限不足、読み取り専用のファイルシステム、存在しないファイルやフォルダー、無効な Target 設定)にはわかりやすい説明も付き、別の場所を指す Skills の symlink には **Force をオンにする** が表示され、変更一覧でもその Target に印が付く。すべての Target が失敗した場合も、同じように一覧表示される。**前回の同期** カードには、直近の sync で失敗した Target が表示される |
|
||||
| **Git Sync** | Source リポジトリのコミットとプッシュ、remote にまだないコミットのプッシュ、プルを実行。ページを開くと remote から fetch するため、**Pull** には remote にあるコミット数が表示される。プルはリポジトリのスコープ(`skills`、`agents`、`extras`、または `root`)が保持するものを sync する。詳細は [`pull`](/docs/reference/commands/pull) を参照。remote に新しいコミットがあるためにプッシュが拒否された場合、エラーに **Pull** が表示される。最初のプルが remote とマージできない場合、remote ブランチでローカルファイルを置き換える force pull を提案する |
|
||||
| **Hubs** | Skills ページから移動。**Browse** は hub をフィルタしてそこからインストール、**My hubs** はインストール済み Skill からインデックスを組み立て、検証してエクスポートする。[`hub`](/docs/reference/commands/hub) を参照 |
|
||||
| **Hubs** | スキル ページから移動。内蔵の hub、保存済みの hub、自分の Hub(**自分の**)を一覧表示し、選ぶとその Skill を絞り込んでインストールできる。**Hub を追加・作成** は既存の hub の追加、新しい Hub の作成、`skillshare-hub.json` の読み込みを行う。自分の Hub は **編集** で変更し、**共有** でインデックスをダウンロードして `hub add` コマンドを作る。[`hub`](/docs/reference/commands/hub) を参照 |
|
||||
| **Skills** / **Agents** | インストール済みの項目、**Updates** タブ、**Trash** タブ。Skills にはさらに、Target のコンテキストに Skill が追加するトークン数を見積もる **Analyze** タブがある。**Install** は GitHub を検索するか、URL やパスからインストールする。**+ New Skill** は作成ウィザードを開く。一覧とカードビューは **Folder**(tracked repo、`frontend/react` のようなフォルダ、または **Root**)でフィルタでき、**Folder** でグループ化もできる。Root が先頭で、残りのフォルダは名前の A→Z 順。**tree** ビューは左に source のフォルダ、右に詳細を表示する。フォルダや Skill をクリックして選択し、Cmd/Ctrl クリックで選択に追加、Shift クリックで範囲選択、Skill をダブルクリックで開く。右側では、選択したものすべてを 1 つのスイッチで有効・無効にし、targets を設定し(tracked repo とそのサブフォルダも含む)、各 Skill を個別のスイッチ付きで一覧する。tracked repo では **Update repo** と **Uninstall repo** も使える。`disable-model-invocation: true` を持つ Skill は、一覧・タイル・詳細ページで **manual only** タグが付く。これは [`list`](/docs/reference/commands/list) で `M` キーが切り替えるのと同じ状態。Skill エディタでは、**Add field** が各フロントマターフィールドの説明を表示する。**Sync skills** / **Sync agents** はプレビューしてから、その種類だけをすべての Target に sync する。update、アンインストール、collect の後に表示される **Sync Now** からも同じダイアログが開く |
|
||||
| **Extras** | **フォルダー**: Skill と一緒に sync される rules、commands、その他のフォルダ。**AGENTS.md**: global モードでは共有 `AGENTS.md` と、それを使う Target。Project では Project の `./AGENTS.md` と、各 Target がそれを読み込めるか。[1 つの AGENTS.md をツール間で共有する](../../how-to/daily-tasks/sharing-instructions.md)を参照 |
|
||||
| **MCP** | サーバーごとに 1 行表示され、sync 先の Agent がチップとして並び、行のカウントボタンでそれらのトグルを開く。**サーバーを追加** は URL、コマンド、貼り付けたスニペット、またはファイルを受け付ける。**target からインポート** はインストール済みの Agent が既に持っているものを読み込む。各サーバーのメニューには **各 Agent に書き込まれる設定を表示** があり、source とすべての Agent のファイルを一覧表示し、選んだものを未保存の編集を含めて表示する。コンフリクトでは **その Agent からインポート** か **ソースで上書き** を選べる。Pi サーバーでは、サーバーのダイアログで [Pi の MCP モード](./mcp.md#pi-choose-your-mcp-extension)(既定は組み込み)と、ツールの公開方法やその他の Pi 設定を選び、後者は [`piOptions`](./mcp.md#pi-options) を JSON で受け付ける。**デフォルト** は `mcp.targets` と `mcp.directTools` を編集する。Sync ボックスの **Sync MCP** は保留中の変更を一覧表示し、MCP の設定ファイルだけを書き込み、それぞれのバックアップを保存する。その下では [**チェック**](./mcp.md#check-servers-before-an-agent-starts-them) がサーバーをチェックし、**バックアップと復元** でそれらのバックアップをプレビューして復元できる。 |
|
||||
|
||||
+16
-20
@@ -140,42 +140,38 @@ GitHub/GHE Hub가 SSH로 로드되면, 동일한 호스트의 도메인 접두
|
||||
|
||||
### JSON을 작성하지 않고 Hub 만들기
|
||||
|
||||
대시보드(`skillshare ui`)에서 **Skills → Hubs → My hubs → New Hub**를 여세요.
|
||||
대시보드(`skillshare ui`)에서 **Skills → Hub**를 열고 **Hub 추가 또는 만들기 → 새 Hub 만들기**를 선택하세요. 새 Hub는 바로 편집 상태로 열립니다.
|
||||
|
||||
1. 초안에 이름과 선택적 설명을 지정하세요. 이는 로컬에서 초안을 식별하는 용도이며 내보낸 index에는 포함되지 않습니다.
|
||||
2. **Choose installed skills**를 선택하고 공유할 Skill을 선택해 추가하세요. 또는 **Add source manually**를 사용하세요.
|
||||
3. 각 Skill의 표시 이름, 설명, 태그, 설치 Source를 편집하세요. 예를 들어 `runkids/demo-skills/skills/pdf`는 원격 저장소 내부의 Skill을 식별합니다. **Advanced** 섹션은 여러 Skill을 포함하는 저장소를 위한 선택적 `skill` 셀렉터를 유지합니다.
|
||||
4. **Save draft**를 선택하세요. 페이지가 모든 항목을 검사하고 내보내기를 막는 문제가 있으면 표시합니다.
|
||||
5. **Download index**를 선택해 `skillshare-hub.json`을 받으세요.
|
||||
6. 다운로드한 파일을 자신의 Git 저장소에 커밋하거나 HTTP 서버에 업로드하세요. 페이지에 해당 위치를 입력하면 수신자를 위한 `skillshare hub add` 명령을 복사할 수 있습니다.
|
||||
|
||||
아래 초안에서는 한 Skill의 Source가 로컬뿐이라 원격 Source를 지정하기 전까지 내보낼 수 없습니다.
|
||||
|
||||

|
||||
1. Hub에 **이름**과 선택적 **설명**을 지정하세요. 이름은 공유하는 `skillshare hub add` 명령의 `--label`이 되며, 둘 다 내보낸 index에는 포함되지 않습니다.
|
||||
2. **skill 추가**를 선택하세요. **URL 붙여 넣기** 탭에서 **Git URL**을 입력하고 **찾기**를 선택한 뒤 **버전**을 고르고 추가할 Skill을 선택하세요. **설치됨** 탭에서는 이 머신에 설치된 Skill을 선택합니다. 또는 **찾을 수 없나요? 소스를 직접 입력**을 선택해 빈 행을 추가하세요.
|
||||
3. 각 Skill의 **이름**, **소스**, **버전**을 편집하세요. 예를 들어 `runkids/demo-skills/skills/pdf`는 원격 저장소 내부의 Skill을 식별합니다. 행을 펼치면 **스킬 설명**, **태그 (쉼표 구분)**, **스킬 선택자 (선택)**를 편집할 수 있으며, 스킬 선택자는 여러 Skill을 포함하는 저장소에서 Skill을 선택합니다.
|
||||
4. **저장**을 선택하세요. 페이지가 모든 항목을 검사합니다. 다른 사람이 설치할 수 없는 Skill이 있으면 편집기가 열린 채로 해당 행을 표시합니다.
|
||||
5. **공유 → skillshare-hub.json 다운로드**를 선택하세요. 표시된 Skill을 **편집**으로 고치기 전까지 다운로드할 수 없습니다.
|
||||
6. 다운로드한 파일을 자신의 Git 저장소에 커밋하거나 HTTP 서버에 업로드하세요. **공유** 대화상자에 해당 URL을 붙여 넣으면 수신자를 위한 `skillshare hub add` 명령을 복사할 수 있습니다. URL은 Hub와 함께 저장됩니다.
|
||||
|
||||
다운로드는 아무것도 게시하지 **않습니다**. 카탈로그는 Skill을 참조할 뿐 파일을 번들로 포함하지 않습니다. Source 검증은 문법만 확인하며, 저장소가 실제로 존재하는지 또는 수신자가 권한을 가지고 있는지는 확인하지 않습니다. 비공개 저장소는 여전히 접근 권한이 필요합니다.
|
||||
|
||||
:::tip 로컬 Skill도 초안에 유지할 수 있습니다
|
||||
원격 origin을 알 수 없는 설치된 Skill은 로컬 Source와 함께 계속 표시됩니다. 이를 초안에 저장할 수 있습니다. 원격 설치 Source를 제공하거나 해당 항목을 제거할 때까지 내보내기가 차단됩니다. 빌더는 이를 조용히 누락시키지 않습니다.
|
||||
:::tip 로컬 Skill도 Hub에 유지할 수 있습니다
|
||||
원격 origin을 알 수 없는 설치된 Skill은 로컬 Source를 유지합니다. 이를 Hub에 저장할 수 있습니다. 원격 설치 Source를 제공하거나 해당 항목을 제거할 때까지 다운로드가 차단됩니다. 빌더는 이를 조용히 누락시키지 않습니다.
|
||||
:::
|
||||
|
||||
### 카탈로그 재개 또는 가져오기
|
||||
|
||||
초안은 대시보드를 실행하는 머신에서 활성 설정 파일 옆의 `hub-drafts/`에 저장됩니다. Global 및 Project 설정은 별도의 초안을 가집니다. 다시 로드하기 전에 **Save draft**를 사용하세요. 저장하지 않은 변경 사항이 있는 채로 나가면 변경 사항을 버릴지 묻는 메시지가 표시되며, 오래된 창에서의 저장은 최신 리비전을 덮어쓰지 못하도록 거부됩니다. **Reload saved draft**는 최신 버전을 가져옵니다.
|
||||
내 Hub는 Hub 목록에 **내 Hub**로 표시됩니다. 이들은 대시보드를 실행하는 머신에서 활성 설정 파일 옆의 `hub-drafts/`에 저장됩니다. Global 및 Project 설정은 별도의 Hub를 가집니다. 다시 로드하기 전에 **저장**을 선택하세요. 편집 중에는 Hub 목록이 잠기며, 저장하지 않은 변경 사항이 있는 채로 나가면 변경 사항을 버릴지 묻는 메시지가 표시됩니다. 오래된 창에서의 저장은 최신 리비전을 덮어쓰지 못하도록 거부됩니다. **취소**는 마지막으로 저장된 버전을 다시 불러옵니다.
|
||||
|
||||
기존 v1 `skillshare-hub.json`(최대 4MB)을 가져오려면 **Import JSON**을 사용하세요. 지원되지 않는 버전과 잘못된 필드 유형은 오류를 발생시킵니다. 표시 이름이 같은 항목도 별도로 유지됩니다. 추가 JSON 필드와 `skill` 셀렉터는 보존됩니다. 이전 index에 `sourcePath`가 포함되어 있다면, 기존 index 리더와 마찬가지로 상대 Source가 로컬 경로로 해석됩니다. 내보내기 전에 원격 Source로 변경해야 합니다.
|
||||
기존 v1 `skillshare-hub.json`(최대 4MB)을 가져오려면 **Hub 추가 또는 만들기 → skillshare-hub.json 가져오기**를 사용하세요. 지원되지 않는 버전과 잘못된 필드 유형은 오류를 발생시킵니다. 표시 이름이 같은 항목도 별도로 유지됩니다. 추가 JSON 필드와 `skill` 셀렉터는 보존됩니다. 이전 index에 `sourcePath`가 포함되어 있다면, 기존 index 리더와 마찬가지로 상대 Source가 로컬 경로로 해석됩니다. 내보내기 전에 원격 Source로 변경해야 합니다.
|
||||
|
||||
이식 가능한 내보내기는 작성자의 `sourcePath`와 알려진 로컬 메타데이터(`relPath`, `flatName`, `installedAt`, `isInRepo`)를 제거합니다. 여기에는 초안의 이름, 설명, ID, 리비전이 아니라 index만 포함됩니다. 항목의 Source나 skill 셀렉터를 변경하면 이전의 audit 점수, 라벨, 타임스탬프가 지워집니다. URL 자격 증명, 쿼리 문자열, 프래그먼트는 거부됩니다. 저장소 인증은 별도로 구성하세요.
|
||||
이식 가능한 내보내기는 작성자의 `sourcePath`와 알려진 로컬 메타데이터(`relPath`, `flatName`, `installedAt`, `isInRepo`)를 제거합니다. 여기에는 Hub의 이름, 설명, ID, 리비전, 호스팅 URL이 아니라 index만 포함됩니다. 항목의 Source나 skill 셀렉터를 변경하면 이전의 audit 점수, 라벨, 타임스탬프가 지워집니다. URL 자격 증명, 쿼리 문자열, 프래그먼트는 거부됩니다. 저장소 인증은 별도로 구성하세요.
|
||||
|
||||
**Delete draft**는 확인을 요청하며 해당 초안만 삭제합니다. Skill을 제거하거나, 호스팅된 index를 삭제하거나, 구독한 Hub를 제거하지 않습니다.
|
||||
**더 보기 → Hub 삭제**는 확인을 요청하며 해당 Hub만 삭제합니다. Skill을 제거하거나, 호스팅된 index를 삭제하거나, 구독한 Hub를 제거하지 않습니다.
|
||||
|
||||
### 공유된 Hub 검색
|
||||
|
||||
1. **Skills → Install**을 여세요.
|
||||
2. 검색 소스 선택기에서 Hub를 선택하세요. 설치 대화상자의 Hub manager를 사용해 URL, SSH 저장소, 또는 로컬 index 경로를 추가하세요.
|
||||
1. **Skills → 설치**를 열고 **검색**을 선택하세요.
|
||||
2. **위치** 선택기에서 Hub를 선택하세요. URL, SSH 저장소, 또는 로컬 index 경로를 추가하려면 선택기 옆의 **허브 관리**를 선택한 뒤 Hub 페이지에서 **Hub 추가 또는 만들기 → 기존 Hub 추가**를 선택하세요.
|
||||
3. Skill을 검색, 미리보기, 설치하세요.
|
||||
|
||||
구독한 Hub Source는 활성 skillshare 설정에 저장되며 CLI와 공유됩니다. 이는 **My hubs**의 초안과는 별개입니다.
|
||||
Hub 페이지에서 Hub를 선택해 해당 Skill을 필터링하고 바로 설치할 수도 있습니다. 구독한 Hub Source는 활성 skillshare 설정에 저장되며 CLI와 공유됩니다. 이는 내 Hub와는 별개입니다.
|
||||
|
||||
기존의 `skillshare hub index` 명령과 `/api/hub/index` 엔드포인트는 로컬 Source 지원을 포함해 이전과 동일하게 index를 생성합니다. 위의 이식 가능한 내보내기 규칙은 대시보드 빌더에도 적용됩니다.
|
||||
|
||||
|
||||
@@ -89,7 +89,7 @@ skillshare ui start --clear-cache
|
||||
| **Dashboard** | skill, agent, extras, MCP 서버, plugin, target의 개수와 주의가 필요한 항목 |
|
||||
| **Sync** | target별로 기록 전에 모든 변경 사항을 미리 봅니다. 포함할 부분(Skills, Agents, Extras, MCP)을 선택합니다. target 내부에서 편집된 파일은 **Force**가 켜져 있지 않은 한 유지됩니다. target에만 존재하는 항목은 여기서 source로 다시 수집할 수 있습니다. 각 sync는 먼저 target 폴더를 백업합니다. target이 실패해도 다른 target은 sync됩니다. 실패한 target은 해당 부분(Skills, Agents, Extras, Config)과 오류와 함께 다른 경고보다 위에 표시되고, 흔한 원인(다른 곳을 가리키는 symlink, 권한 거부, 읽기 전용 파일 시스템, 없는 파일이나 폴더, 잘못된 target 설정)에는 쉬운 설명도 붙으며, 다른 곳을 가리키는 Skills symlink에는 **Force 켜기**가 제공되며, 변경 목록에서도 해당 target이 표시됩니다. 모든 target이 실패해도 같은 방식으로 표시됩니다. **마지막 동기화** 카드에는 가장 최근 sync에서 실패한 target이 표시됩니다 |
|
||||
| **Git Sync** | source repo를 commit하고 push하며, 아직 remote에 없는 커밋을 push하고, pull합니다. 페이지를 열면 remote에서 fetch하므로 **Pull** 버튼에 remote에 있는 커밋 수가 표시됩니다. Pull은 [`pull`](/docs/reference/commands/pull)과 마찬가지로 repo scope가 담고 있는 것(`skills`, `agents`, `extras`, 또는 `root`)을 동기화합니다. remote에 더 새로운 커밋이 있어 push가 거부되면 오류 알림에서 **Pull**을 제공합니다. 첫 pull이 remote와 병합할 수 없을 때는 로컬 파일을 remote 브랜치로 교체하는 force pull을 제공합니다 |
|
||||
| **Hubs** | Skills 페이지에서 접근합니다. **Browse**는 hub를 필터링하고 그곳에서 설치합니다. **My hubs**는 설치된 skill로부터 인덱스를 구성하고 검증한 후 내보냅니다. [`hub`](/docs/reference/commands/hub) 참고 |
|
||||
| **Hubs** | Skills 페이지에서 접근합니다. 내장 hub, 저장된 hub, 내 Hub(**내 Hub**)를 나열하며, 하나를 선택해 Skill을 필터링하고 설치합니다. **Hub 추가 또는 만들기**는 기존 hub 추가, 새 Hub 만들기, `skillshare-hub.json` 가져오기를 합니다. 내 Hub는 **편집**으로 변경하고 **공유**로 인덱스를 다운로드하고 `hub add` 명령을 만듭니다. [`hub`](/docs/reference/commands/hub) 참고 |
|
||||
| **Skills** / **Agents** | 설치된 항목, **Updates** 탭, **Trash** 탭. Skills에는 각 skill이 target의 context에 추가하는 토큰 수를 추정하는 **Analyze** 탭도 있습니다. **Install**은 GitHub를 검색하거나 URL 또는 경로에서 설치합니다. **+ New Skill**은 생성 마법사를 엽니다. 목록과 카드 보기는 **Folder**(tracked repo, `frontend/react` 같은 폴더, 또는 **Root**)로 필터링하고 **Folder**로 그룹화할 수 있으며, Root가 먼저 오고 나머지 폴더는 이름 A→Z 순입니다. **tree** 보기는 왼쪽에 source 폴더를, 오른쪽에 상세 정보를 보여 줍니다. 폴더나 skill을 클릭해 선택하고, Cmd/Ctrl 클릭으로 선택에 추가하고, Shift 클릭으로 범위를 선택하며, skill을 더블클릭하면 열립니다. 오른쪽에서는 선택한 모든 항목을 스위치 하나로 켜거나 끄고, targets를 설정하며(tracked repo와 그 하위 폴더 포함), 각 skill을 개별 스위치와 함께 나열합니다. tracked repo에는 **Update repo**와 **Uninstall repo**도 있습니다. `disable-model-invocation: true`가 설정된 skill은 목록, 타일, 상세 페이지에 **manual only** 태그가 표시되며, 이는 [`list`](/docs/reference/commands/list)에서 `M`으로 전환하는 것과 같은 상태입니다. skill 편집기에서 **Add field**는 각 frontmatter 필드가 하는 역할을 설명합니다. **Sync skills** / **Sync agents**는 미리 본 뒤 해당 종류만 모든 target에 동기화합니다. 업데이트, 제거 또는 collect 후에는 **Sync Now**에서 같은 대화상자가 열립니다 |
|
||||
| **Extras** | **폴더**: skill과 함께 동기화되는 rules, commands, 기타 폴더. **AGENTS.md**: global 모드에서는 공유 `AGENTS.md`와 그것을 쓰는 target, 프로젝트에서는 프로젝트의 `./AGENTS.md`와 각 target이 그것을 읽는지 여부. [여러 도구에서 하나의 AGENTS.md 공유하기](../../how-to/daily-tasks/sharing-instructions.md)를 참고하세요 |
|
||||
| **MCP** | 서버당 한 행이며, 동기화 대상인 Agent가 chip으로 표시되며, 행의 카운트 버튼을 누르면 해당 토글이 열립니다. **서버 추가**는 URL, command, 붙여넣은 snippet 또는 파일을 받습니다. **target에서 가져오기**는 설치된 Agent가 이미 가지고 있는 것을 읽어옵니다. 각 서버의 메뉴에는 **각 Agent에 기록될 설정 보기**가 있어 source와 모든 Agent의 파일을 나열하고, 선택한 파일을 저장되지 않은 편집을 포함해 보여줍니다. 충돌 시 **해당 Agent에서 가져오기** 또는 **원본으로 덮어쓰기**를 제공합니다. Pi 서버의 경우, 서버 대화상자에서 [Pi MCP 모드](./mcp.md#pi-choose-your-mcp-extension)(기본값은 내장)와 도구 노출 방식 및 기타 Pi 설정을 선택하며, 이 설정은 [`piOptions`](./mcp.md#pi-options)를 JSON으로 받습니다. **기본값**은 `mcp.targets`와 `mcp.directTools`를 편집합니다. Sync 박스의 **Sync MCP**는 대기 중인 변경 사항을 나열하고 MCP 설정 파일만 작성하며, 각 파일의 백업을 남깁니다. 그 아래에서 [**검사**](./mcp.md#check-servers-before-an-agent-starts-them)는 서버를 검사하고, **백업 및 복원**는 그 백업을 미리 보고 복원합니다. |
|
||||
|
||||
+15
-19
@@ -140,40 +140,36 @@ SSH hub 来源会使用你的 SSH agent/密钥来克隆,因此适用于私有
|
||||
|
||||
### 不写 JSON 也能建立 Hub
|
||||
|
||||
在仪表板(`skillshare ui`)中打开 **Skills → Hubs → My hubs → New Hub**。
|
||||
在仪表板(`skillshare ui`)中打开 **Skill → Hubs**,再选择 **添加或创建 Hub → 创建新的 Hub**。新的 Hub 会直接进入编辑。
|
||||
|
||||
1. 为草稿命名并填写可选的描述。这些仅用于本地识别草稿,不会包含在导出的 index 中。
|
||||
2. 选择 **Choose installed skills**,勾选要分享的 Skill 并加入;或使用 **Add source manually**。
|
||||
3. 编辑每个 Skill 的显示名称、描述、标签与安装来源。例如,`runkids/demo-skills/skills/pdf` 用来指向远端仓库中的某个 Skill。**Advanced** 区块保留一个可选的 `skill` 选择器,用于包含多个 Skill 的仓库。
|
||||
4. 选择 **Save draft**。此页面会检查每个条目并显示任何导出阻挡项。
|
||||
5. 选择 **Download index** 以取得 `skillshare-hub.json`。
|
||||
6. 将下载的文件 commit 到你自己的 Git 仓库,或上传到 HTTP 服务器。在页面中输入该位置,即可复制一条给接收者使用的 `skillshare hub add` 指令。
|
||||
|
||||
下图的草稿中,有一个 skill 只有本地来源,因此在补上远程来源之前无法导出:
|
||||
|
||||

|
||||
1. 为 Hub 填写 **名称** 和可选的 **说明**。名称会成为你分享的 `skillshare hub add` 指令中的 `--label`;两者都不会包含在导出的 index 中。
|
||||
2. 选择 **添加 skill**。在 **粘贴网址** 标签页输入 **Git 网址**,选择 **查找**,挑选 **版本**,再勾选要添加的 Skill。在 **已安装的** 标签页可挑选本机已安装的 Skill。也可以选择 **找不到?手动填写来源** 添加一行空白条目。
|
||||
3. 编辑每个 Skill 的 **名称**、**来源** 与 **版本**。例如,`runkids/demo-skills/skills/pdf` 用来指向远端仓库中的某个 Skill。展开该行可编辑 **技能说明**、**标签(逗号分隔)** 与 **技能选择器(可选)**,后者用于在包含多个 Skill 的仓库中选择 Skill。
|
||||
4. 选择 **保存**。此页面会检查每个条目;若有别人装不了的 Skill,编辑器会保持打开并标示该行。
|
||||
5. 选择 **分享 → 下载 skillshare-hub.json**。在用 **编辑** 修好被标示的 Skill 之前,无法下载。
|
||||
6. 将下载的文件 commit 到你自己的 Git 仓库,或上传到 HTTP 服务器。在 **分享** 对话框中粘贴该网址,即可复制一条给接收者使用的 `skillshare hub add` 指令。网址会随 Hub 一起保存。
|
||||
|
||||
下载并不会发布任何内容。此目录只引用 Skill,不会打包其文件内容。来源验证只检查语法,不检查仓库是否存在或接收者是否具有权限。私有仓库仍然需要相应的访问权限。
|
||||
|
||||
:::tip 本地 Skill 也可留在草稿中
|
||||
没有已知远端来源的已安装 Skill,仍会以本地来源的形式显示,你可以将它保存进草稿。导出会被阻挡,直到你提供远端安装来源或移除该条目;建构器绝不会默默地略过它。
|
||||
:::tip 本地 Skill 也可留在 Hub 中
|
||||
没有已知远端来源的已安装 Skill,仍会保留本地来源,你可以将它保存进 Hub。下载会被阻挡,直到你提供远端安装来源或移除该条目;建构器绝不会默默地略过它。
|
||||
:::
|
||||
|
||||
### 恢复或导入目录
|
||||
|
||||
草稿保存在运行仪表板的机器上,位于当前设置文件旁的 `hub-drafts/` 目录。Global 与 project 设置各自有独立的草稿。重新加载前请先使用 **Save draft**。带着未保存的变更离开时会提示你是否放弃;来自过期窗口的保存会被拒绝,以免覆盖更新的版本。**Reload saved draft** 会取回最新版本。
|
||||
你自己的 Hub 会在 Hub 列表中标为 **我的**。它们保存在运行仪表板的机器上,位于当前设置文件旁的 `hub-drafts/` 目录。Global 与 project 设置各自有独立的 Hub。重新加载前请先选择 **保存**。编辑期间 Hub 列表会锁定;带着未保存的变更离开时会提示你是否放弃。来自过期窗口的保存会被拒绝,以免覆盖更新的版本。**取消** 会重新加载最新保存的版本。
|
||||
|
||||
对既有的 v1 版 `skillshare-hub.json`(最大 4 MB)使用 **Import JSON**。不支持的版本与无效的字段类型会产生错误。显示名称相同的条目仍会各自独立保留。额外的 JSON 字段与 `skill` 选择器会被保留。若旧版 index 含有 `sourcePath`,相对来源会依照既有 index 读取器的方式解析为本地路径;在导出前必须先改为远端来源。
|
||||
对既有的 v1 版 `skillshare-hub.json`(最大 4 MB)使用 **添加或创建 Hub → 导入 skillshare-hub.json**。不支持的版本与无效的字段类型会产生错误。显示名称相同的条目仍会各自独立保留。额外的 JSON 字段与 `skill` 选择器会被保留。若旧版 index 含有 `sourcePath`,相对来源会依照既有 index 读取器的方式解析为本地路径;在导出前必须先改为远端来源。
|
||||
|
||||
**Delete draft** 会要求确认,且只会删除该份草稿,不会卸载 Skill、删除已托管的 index,或移除已订阅的 Hub。
|
||||
**更多操作 → 删除 Hub** 会要求确认,且只会删除该 Hub,不会卸载 Skill、删除已托管的 index,或移除已订阅的 Hub。
|
||||
|
||||
### 搜索已分享的 Hub
|
||||
|
||||
1. 打开 **Skills → Install**。
|
||||
2. 在搜索来源选择器中选择一个 Hub。可在安装对话框的 Hub 管理器中新增 URL、SSH 仓库或本地 index 路径。
|
||||
1. 打开 **Skill → 安装**,选择 **搜索**。
|
||||
2. 在 **来源** 选择器中选择一个 Hub。若要添加 URL、SSH 仓库或本地 index 路径,选择选择器旁的 **管理 Hub**,再在 Hubs 页面选择 **添加或创建 Hub → 添加已有的 Hub**。
|
||||
3. 搜索、预览并安装 Skill。
|
||||
|
||||
已订阅的 Hub 来源会保存在当前的 skillshare 设置中,并与 CLI 共享。它们与 **My hubs** 中的草稿是分开的。
|
||||
你也可以在 Hubs 页面选择一个 Hub,直接过滤并安装其中的 Skill。已订阅的 Hub 来源会保存在当前的 skillshare 设置中,并与 CLI 共享。它们与你自己的 Hub 是分开的。
|
||||
|
||||
既有的 `skillshare hub index` 指令与 `/api/hub/index` 端点会继续照旧生成 index,包含对本地来源的支持。上述可移植导出规则同样适用于仪表板中的建构器。
|
||||
|
||||
|
||||
+1
-1
@@ -89,7 +89,7 @@ skillshare ui start --clear-cache
|
||||
| **Dashboard** | skills、agents、extras、MCP servers、plugins 和 targets 的计数,以及需要关注的项目 |
|
||||
| **Sync** | 在写入之前,按 Target 预览每一处变更。选择要包含的部分(Skills、Agents、Extras、MCP)。在 Target 内部编辑过的文件会被保留,除非开启了 **Force**。只存在于某个 Target 中的项目可以从这里收集回 Source。每次 sync 会先备份 Target 目录。某个 Target 失败时,其他 Target 仍会 sync:页面会在其他警告上方列出每个失败的 Target 及其部分(Skills、Agents、Extras 或 Config)和错误,常见原因(symlink 指向别处、权限不足、只读文件系统、文件或文件夹不存在、Target 设置无效)还会附上一句易懂的说明;若 Skills 的 symlink 指向别处,会提供 **开启 Force**;变更列表中也会标出该 Target。即使所有 Target 都失败,也会以同样方式列出。**上次同步** 卡片会列出最近一次 sync 中失败的 Target |
|
||||
| **Git Sync** | 提交并推送 source 仓库,推送尚未上 remote 的提交,并拉取。打开页面时会先从 remote fetch,所以 **Pull** 会显示 remote 有多少个新提交。Pull 会同步该仓库 scope 所涵盖的内容(`skills`、`agents`、`extras` 或 `root`),与 [`pull`](/docs/reference/commands/pull) 相同。当 remote 因为有更新的提交而拒绝 push 时,错误提示会提供 **Pull**。当首次 pull 无法与 remote 合并时,它会提供一个强制 pull 选项,用 remote 分支替换本地文件 |
|
||||
| **Hubs** | 从 Skills 页面进入。**Browse** 过滤某个 hub 并从中安装;**My hubs** 从已安装的 skills 组装出一个索引,验证并导出它。参见 [`hub`](/docs/reference/commands/hub) |
|
||||
| **Hubs** | 从 Skill 页面进入。列出内置 hub、已保存的 hubs 与你自己的 Hub(**我的**);选择一个即可过滤并安装其中的 skills。**添加或创建 Hub** 可添加已有的 hub、创建新的 Hub,或导入 `skillshare-hub.json`。自己的 Hub 通过 **编辑** 修改;**分享** 会下载索引并生成 `hub add` 命令。参见 [`hub`](/docs/reference/commands/hub) |
|
||||
| **Skills** / **Agents** | 已安装的项目、**Updates** 标签页,以及 **Trash** 标签页。Skills 还有一个 **Analyze** 标签页,估算每个 skill 为某个 target 的上下文增加了多少 token。**Install** 可从 GitHub 搜索,或从 URL 或路径安装。**+ New Skill** 打开创建向导。列表和卡片视图可以按 **Folder**(tracked repo、`frontend/react` 这类文件夹,或 **Root**)过滤,也可以按 **Folder** 分组,Root 排在最前,其余文件夹按名称 A→Z 排序。**tree** 视图左侧显示 source 文件夹,右侧显示详情:点击文件夹或 skill 进行选择,Cmd/Ctrl 点击加入选择,Shift 点击选择范围,双击 skill 打开它。右侧可以用一个开关启用或停用所有选中的项目、设置它们的 targets(包括 tracked repo 及其子文件夹),并列出每个 skill 各自的开关;tracked repo 还提供 **Update repo** 和 **Uninstall repo**。带有 `disable-model-invocation: true` 的 skill 会在列表、卡片和详情页上带有 **manual only** 标签,这与 [`list`](/docs/reference/commands/list) 用 `M` 切换的状态相同。在 skill 编辑器中,**Add field** 会描述每个 frontmatter 字段的作用。**Sync skills** / **Sync agents** 会先预览,然后只将该类型 sync 到每个 target;在更新、卸载或 collect 之后,点击 **Sync Now** 也会打开同一个对话框 |
|
||||
| **Extras** | **文件夹**:与 skills 一起同步的 rules、commands 和其他目录。**AGENTS.md**:在 global mode 下是共享 `AGENTS.md` 以及哪些 target 在使用它们;在项目中是项目的 `./AGENTS.md` 以及每个 target 是否会读取它。参见[让多个工具共用一份 AGENTS.md](../../how-to/daily-tasks/sharing-instructions.md) |
|
||||
| **MCP** | 每个 server 一行,并以 chip 显示它同步到的 Agents;行上的计数按钮会打开它们的开关。**添加服务器** 接受 URL、命令、粘贴的片段或文件;**从 target 导入** 会读取某个已安装 Agent 现有的配置。每个 server 的菜单都有 **查看各 Agent 会写入的配置**,会列出来源和每个 Agent 的文件,并显示你选中的那一个,包括尚未保存的编辑。冲突会提供 **从该 Agent 导入** 或 **使用来源覆盖**。对于 Pi server,server 对话框可以选择 [Pi MCP 模式](./mcp.md#pi-choose-your-mcp-extension)(默认为内置),以及工具暴露方式和其他 Pi 设置,后者以 JSON 形式填写 [`piOptions`](./mcp.md#pi-options)。**默认值** 用于编辑 `mcp.targets` 和 `mcp.directTools`。Sync 框中的 **Sync MCP** 会列出待写入的更改,并只写入 MCP 配置文件,同时为每个文件保留一份备份;其下方的 [**检查**](./mcp.md#check-servers-before-an-agent-starts-them) 用于检查 server,**备份与还原** 用于预览并恢复这些备份。 |
|
||||
|
||||
+16
-20
@@ -140,42 +140,38 @@ SSH hub source 會使用你的 SSH agent/金鑰進行 clone,因此適用於私
|
||||
|
||||
### 不寫 JSON 也能建立 Hub
|
||||
|
||||
在 dashboard(`skillshare ui`)中開啟 **Skills → Hubs → My hubs → New Hub**。
|
||||
在 dashboard(`skillshare ui`)中開啟 **Skills → Hubs**,再選擇 **加入或建立 Hub → 建立新的 Hub**。新的 Hub 會直接進入編輯。
|
||||
|
||||
1. 為草稿命名並填寫(選用的)描述。這些資訊僅用於在本機識別草稿;不會包含在匯出的索引中。
|
||||
2. 選擇 **Choose installed skills**,挑選要分享的 skills 並新增。或使用 **Add source manually**。
|
||||
3. 編輯每個 skill 的顯示名稱、描述、標籤與安裝 source。例如,`runkids/demo-skills/skills/pdf` 用來識別遠端 repository 中的某個 skill。**Advanced** 區塊保留了一個選用的 `skill` 選擇器,供包含多個 skills 的 repository 使用。
|
||||
4. 選擇 **Save draft**。頁面會檢查每個項目,並顯示任何阻擋匯出的問題。
|
||||
5. 選擇 **Download index** 以取得 `skillshare-hub.json`。
|
||||
6. 將下載的檔案提交到你自己的 Git repository,或上傳到 HTTP 伺服器。在頁面中輸入該位置,即可複製一段供接收者使用的 `skillshare hub add` 指令。
|
||||
|
||||
下圖的草稿中,有一個 skill 只有本機 source,因此在補上遠端 source 之前無法匯出:
|
||||
|
||||

|
||||
1. 為 Hub 填寫 **名稱** 與(選用的)**說明**。名稱會成為你分享的 `skillshare hub add` 指令中的 `--label`;兩者都不會包含在匯出的索引中。
|
||||
2. 選擇 **加入 skill**。在 **貼上網址** 分頁輸入 **Git 網址**,選擇 **尋找**,挑選 **版本**,再勾選要加入的 skills。在 **已安裝的** 分頁則可挑選這台機器上已安裝的 skills。也可以選擇 **找不到?手動填寫來源** 新增一列空白項目。
|
||||
3. 編輯每個 skill 的 **名稱**、**來源** 與 **版本**。例如,`runkids/demo-skills/skills/pdf` 用來識別遠端 repository 中的某個 skill。展開該列可編輯 **技能說明**、**標籤(以逗號分隔)** 與 **技能選擇器(選填)**,後者用來在包含多個 skills 的 repository 中選取 skill。
|
||||
4. 選擇 **儲存**。頁面會檢查每個項目;若有別人裝不到的 skill,編輯器會保持開啟並標示該列。
|
||||
5. 選擇 **分享 → 下載 skillshare-hub.json**。在用 **編輯** 修好被標示的 skills 之前,無法下載。
|
||||
6. 將下載的檔案提交到你自己的 Git repository,或上傳到 HTTP 伺服器。在 **分享** 對話框中貼上該網址,即可複製一段供接收者使用的 `skillshare hub add` 指令。網址會隨 Hub 一起儲存。
|
||||
|
||||
下載動作**不會**發布任何東西。目錄只是參照 skills,並不會打包它們的檔案。Source 驗證只會檢查語法,不會確認 repository 是否存在,或接收者是否有權限。私有 repositories 仍然需要存取權限。
|
||||
|
||||
:::tip 本機的 skills 可以留在草稿中
|
||||
沒有已知遠端來源的已安裝 skill,仍會以其本機 source 顯示。你可以將它儲存在草稿中。在你提供遠端安裝 source 或移除該項目之前,匯出會被阻擋;建構工具絕不會默默地將它排除。
|
||||
:::tip 本機的 skills 可以留在 Hub 中
|
||||
沒有已知遠端來源的已安裝 skill,仍會保留其本機 source。你可以將它儲存在 Hub 中。在你提供遠端安裝 source 或移除該項目之前,下載會被阻擋;建構工具絕不會默默地將它排除。
|
||||
:::
|
||||
|
||||
### 繼續編輯或匯入目錄
|
||||
|
||||
草稿會儲存在執行 dashboard 的機器上,位於目前使用中設定檔旁邊的 `hub-drafts/` 目錄。Global 與 project 設定各自擁有獨立的草稿。重新載入前請先使用 **Save draft**。若帶著未儲存的變更離開,系統會提示你捨棄它們;來自過期視窗的儲存動作會被拒絕,以避免覆寫較新的修訂版本。**Reload saved draft** 會取得最新版本。
|
||||
你自己的 Hub 會在 Hub 清單中標示為 **我的**。它們儲存在執行 dashboard 的機器上,位於目前使用中設定檔旁邊的 `hub-drafts/` 目錄。Global 與 project 設定各自擁有獨立的 Hub。重新載入前請先選擇 **儲存**。編輯期間 Hub 清單會鎖定;若帶著未儲存的變更離開,系統會提示你捨棄它們。來自過期視窗的儲存動作會被拒絕,以避免覆寫較新的修訂版本。**取消** 會重新載入最新儲存的版本。
|
||||
|
||||
對於既有的 v1 `skillshare-hub.json`(上限 4 MB),請使用 **Import JSON**。不支援的版本與無效的欄位類型會產生錯誤。顯示名稱相同的項目仍會各自獨立。額外的 JSON 欄位與 `skill` 選擇器會被保留。如果較舊的索引包含 `sourcePath`,相對 source 會被解析為本機路徑,與現有的索引讀取器行為一致;在匯出前必須將它們改為遠端 source。
|
||||
對於既有的 v1 `skillshare-hub.json`(上限 4 MB),請使用 **加入或建立 Hub → 匯入 skillshare-hub.json**。不支援的版本與無效的欄位類型會產生錯誤。顯示名稱相同的項目仍會各自獨立。額外的 JSON 欄位與 `skill` 選擇器會被保留。如果較舊的索引包含 `sourcePath`,相對 source 會被解析為本機路徑,與現有的索引讀取器行為一致;在匯出前必須將它們改為遠端 source。
|
||||
|
||||
可攜式匯出會移除作者的 `sourcePath` 與已知的本機 metadata(`relPath`、`flatName`、`installedAt`、`isInRepo`)。它只包含索引本身,不含草稿的名稱、描述、ID 或修訂版本。變更項目的 source 或 skill 選擇器,會清除它先前的 audit 分數、標籤與時間戳記。URL 中的憑證、查詢字串與片段會被拒絕;請另外設定 repository 的驗證方式。
|
||||
可攜式匯出會移除作者的 `sourcePath` 與已知的本機 metadata(`relPath`、`flatName`、`installedAt`、`isInRepo`)。它只包含索引本身,不含 Hub 的名稱、說明、ID、修訂版本或架設網址。變更項目的 source 或 skill 選擇器,會清除它先前的 audit 分數、標籤與時間戳記。URL 中的憑證、查詢字串與片段會被拒絕;請另外設定 repository 的驗證方式。
|
||||
|
||||
**Delete draft** 會要求確認,並只會刪除該份草稿。它不會解除安裝 skills、刪除已架設的索引,或移除已訂閱的 Hub。
|
||||
**更多動作 → 刪除 Hub** 會要求確認,並只會刪除該 Hub。它不會解除安裝 skills、刪除已架設的索引,或移除已訂閱的 Hub。
|
||||
|
||||
### 搜尋已分享的 Hub
|
||||
|
||||
1. 開啟 **Skills → Install**。
|
||||
2. 從搜尋 source 選擇器中選擇一個 Hub。使用安裝對話框中的 Hub manager 新增 URL、SSH repository,或本機索引路徑。
|
||||
1. 開啟 **Skills → 安裝**,選擇 **搜尋**。
|
||||
2. 在 **來源** 選擇器中選擇一個 Hub。若要新增 URL、SSH repository 或本機索引路徑,選擇選擇器旁的 **管理 Hubs**,再到 Hubs 頁面選擇 **加入或建立 Hub → 加入現有的 Hub**。
|
||||
3. 搜尋、預覽並安裝 skills。
|
||||
|
||||
已訂閱的 Hub source 會儲存在目前使用中的 skillshare 設定中,並與 CLI 共用。它們與 **My hubs** 中的草稿是分開的。
|
||||
你也可以在 Hubs 頁面選擇一個 Hub,直接篩選並安裝其中的 skills。已訂閱的 Hub source 會儲存在目前使用中的 skillshare 設定中,並與 CLI 共用。它們與你自己的 Hub 是分開的。
|
||||
|
||||
既有的 `skillshare hub index` 指令與 `/api/hub/index` 端點仍會如往常一樣產生索引,包括支援本機 source。上述的可攜式匯出規則同樣適用於 dashboard 的建構工具。
|
||||
|
||||
|
||||
+1
-1
@@ -89,7 +89,7 @@ skillshare ui start --clear-cache
|
||||
| **Dashboard** | Skills、agents、extras、MCP servers、plugins 與 targets 的數量,以及需要注意的項目 |
|
||||
| **Sync** | 在寫入前預覽每個 target 的每項變更。選擇要包含的部分(Skills、Agents、Extras、MCP)。在 target 內編輯過的檔案,除非開啟 **Force**,否則會保留。只存在於 target 中的項目可以從這裡收集回 source。每次同步都會先備份 target 資料夾。某個 target 失敗時,其他 target 仍會同步:頁面會在其他警告上方列出每個失敗的 target,以及它的部分(Skills、Agents、Extras 或 Config)和錯誤,常見原因(symlink 指向別處、權限不足、唯讀檔案系統、檔案或資料夾不存在、target 設定無效)還會附上一句易懂的說明;若 Skills 的 symlink 指向別處,會提供 **開啟 Force**;變更清單中也會標出該 target。即使所有 target 都失敗,也會以同樣方式列出。**上次同步** 卡片會列出最近一次同步中失敗的 target |
|
||||
| **Git Sync** | Commit 並 push source repo、push 尚未在 remote 上的 commits,以及 pull。開啟頁面時會先從 remote fetch,所以 **Pull** 按鈕會顯示 remote 有幾個新的 commits。Pull 會同步 repo scope 所涵蓋的內容(`skills`、`agents`、`extras` 或 `root`),如同 [`pull`](/docs/reference/commands/pull)。當 remote 因為有較新的 commits 而拒絕 push 時,錯誤訊息會提供 **Pull**。當第一次 pull 無法與 remote 合併時,會提供強制 pull 以本機檔案取代 remote 分支 |
|
||||
| **Hubs** | 從 Skills 頁面進入。**Browse** 篩選 hub 並從中安裝;**My hubs** 從已安裝的 skills 組裝索引、驗證並匯出。參見 [`hub`](/docs/reference/commands/hub) |
|
||||
| **Hubs** | 從 Skills 頁面進入。列出內建 hub、已儲存的 hubs 與你自己的 Hub(**我的**);選擇一個即可篩選並安裝其中的 skills。**加入或建立 Hub** 可加入現有的 hub、建立新的 Hub,或匯入 `skillshare-hub.json`。自己的 Hub 以 **編輯** 修改;**分享** 會下載索引並產生 `hub add` 指令。參見 [`hub`](/docs/reference/commands/hub) |
|
||||
| **Skills** / **Agents** | 已安裝的項目、**Updates** 分頁與 **Trash** 分頁。Skills 還有一個 **Analyze** 分頁,用來估算每個 skill 為 target 的 context 增加多少 tokens。**Install** 可搜尋 GitHub,或從 URL 或路徑安裝。**+ New Skill** 開啟建立精靈。列表與卡片檢視可依 **Folder**(tracked repo、`frontend/react` 這類資料夾,或 **Root**)篩選,也能依 **Folder** 分組,Root 排最前,其餘資料夾依名稱 A→Z 排序。**tree** 檢視左邊顯示 source 資料夾,右邊顯示詳細資訊:點資料夾或 skill 來選取,Cmd/Ctrl 點擊加入選取,Shift 點擊選取範圍,雙擊 skill 開啟它。右邊可用一個開關啟用或停用所有選取的項目、設定它們的 targets(包括 tracked repo 與其子資料夾),並列出每個 skill 各自的開關;tracked repo 另外提供 **Update repo** 與 **Uninstall repo**。帶有 `disable-model-invocation: true` 的 skill 會在列表、其磚塊(tile)與詳細頁面上帶有 **manual only** 標籤,這與 [`list`](/docs/reference/commands/list) 中用 `M` 切換的狀態相同。在 skill 編輯器中,**Add field** 說明每個 frontmatter 欄位的作用。**Sync skills** / **Sync agents** 會先預覽,再只把該類型同步到所有 targets;更新、解除安裝或 collect 之後,從 **Sync Now** 也會開啟同一個對話框 |
|
||||
| **Extras** | **目錄**:與 skills 一同同步的 rules、commands 及其他資料夾。**AGENTS.md**:在 global mode 中是共用 `AGENTS.md` 與使用它們的 targets;在專案中則是專案的 `./AGENTS.md`,以及每個 target 是否讀得到它。詳見[讓多個工具共用一份 AGENTS.md](../../how-to/daily-tasks/sharing-instructions.md) |
|
||||
| **MCP** | 每個 server 一列,並以 chips 顯示它同步至哪些 Agents;列上的計數按鈕會開啟它們的切換開關。**新增伺服器** 接受 URL、指令、貼上的片段或檔案;**從 target 匯入** 讀取已安裝 Agent 目前的設定。每個 server 的選單都有 **檢視各 Agent 會寫入的設定**,會列出來源與每個 Agent 的檔案,並顯示你選取的那一個(含尚未儲存的編輯內容)。衝突時提供 **從該 Agent 匯入** 或 **以來源覆寫**。對於 Pi server,server 對話框可選擇 [Pi MCP 模式](./mcp.md#pi-choose-your-mcp-extension)(預設為內建),以及工具曝光方式與其他 Pi 設定,後者以 JSON 填入 [`piOptions`](./mcp.md#pi-options)。**預設值** 用來編輯 `mcp.targets` 與 `mcp.directTools`。Sync 框中的 **Sync MCP** 會列出待寫入的變更,只寫入 MCP 設定檔,並為每個檔案保留備份;它下方的 [**檢查**](./mcp.md#check-servers-before-an-agent-starts-them) 會檢查 servers,**備份與還原** 則可預覽並還原這些備份。 |
|
||||
|
||||
Reference in New Issue
Block a user