mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-19 02:17:09 +00:00
feat(ui): nest skill packages under their parent in the list view
A package that ships its own SKILL.md plus nested skills used to list every child as a peer, so one large package could fill the page and hide which skills belong together (#624, proposal in #625). The list view now puts each skill under the nearest skill whose folder holds it, within its current group. Packages start collapsed with a nested count, a search opens them so matches stay visible, and paging counts top-level rows so a package is never split across pages. Selection, select-all and bulk actions still work per skill. Closes #624
This commit is contained in:
@@ -694,6 +694,8 @@
|
||||
"resources.folder.collapseAll": "Alle einklappen",
|
||||
"resources.folder.root": "Stammverzeichnis",
|
||||
"resources.folder.expandAll": "Alle ausklappen",
|
||||
"resources.nested.one": "{count} verschachtelter Skill",
|
||||
"resources.nested.other": "{count} verschachtelte Skills",
|
||||
"resources.folder.expand": "{name} ausklappen",
|
||||
"resources.folder.collapse": "{name} einklappen",
|
||||
"resources.folder.noEditableSkills": "Keine Skills in {folder}/ geändert — deaktivierte Skills werden übersprungen",
|
||||
|
||||
@@ -688,6 +688,8 @@
|
||||
"resources.folder.collapseAll": "Collapse all",
|
||||
"resources.folder.root": "Root",
|
||||
"resources.folder.expandAll": "Expand all",
|
||||
"resources.nested.one": "{count} nested skill",
|
||||
"resources.nested.other": "{count} nested skills",
|
||||
"resources.folder.expand": "Expand {name}",
|
||||
"resources.folder.collapse": "Collapse {name}",
|
||||
"resources.folder.noEditableSkills": "No skills in {folder}/ were changed — disabled skills are skipped",
|
||||
|
||||
@@ -694,6 +694,8 @@
|
||||
"resources.folder.collapseAll": "Contraer todo",
|
||||
"resources.folder.root": "Raíz",
|
||||
"resources.folder.expandAll": "Expandir todo",
|
||||
"resources.nested.one": "{count} skill anidado",
|
||||
"resources.nested.other": "{count} skills anidados",
|
||||
"resources.folder.expand": "Expandir {name}",
|
||||
"resources.folder.collapse": "Contraer {name}",
|
||||
"resources.folder.noEditableSkills": "No se cambió ningún skill en {folder}/ — los skills deshabilitados se omiten",
|
||||
|
||||
@@ -694,6 +694,8 @@
|
||||
"resources.folder.collapseAll": "جمع کردن همه",
|
||||
"resources.folder.root": "ریشه",
|
||||
"resources.folder.expandAll": "باز کردن همه",
|
||||
"resources.nested.one": "{count} اسکیل تودرتو",
|
||||
"resources.nested.other": "{count} اسکیل تودرتو",
|
||||
"resources.folder.expand": "باز کردن {name}",
|
||||
"resources.folder.collapse": "بستن {name}",
|
||||
"resources.folder.noEditableSkills": "هیچ اسکیلی در {folder}/ تغییر نکرد — اسکیلهای غیرفعال نادیده گرفته میشوند",
|
||||
|
||||
@@ -694,6 +694,8 @@
|
||||
"resources.folder.collapseAll": "Tout réduire",
|
||||
"resources.folder.root": "Racine",
|
||||
"resources.folder.expandAll": "Tout développer",
|
||||
"resources.nested.one": "{count} skill imbriqué",
|
||||
"resources.nested.other": "{count} skills imbriqués",
|
||||
"resources.folder.expand": "Développer {name}",
|
||||
"resources.folder.collapse": "Réduire {name}",
|
||||
"resources.folder.noEditableSkills": "Aucun skill modifié dans {folder}/ — les skills désactivés sont ignorés",
|
||||
|
||||
@@ -694,6 +694,8 @@
|
||||
"resources.folder.collapseAll": "Ciutkan Semua",
|
||||
"resources.folder.root": "Akar",
|
||||
"resources.folder.expandAll": "Perluas Semua",
|
||||
"resources.nested.one": "{count} skill bersarang",
|
||||
"resources.nested.other": "{count} skill bersarang",
|
||||
"resources.folder.expand": "Perluas {name}",
|
||||
"resources.folder.collapse": "Ciutkan {name}",
|
||||
"resources.folder.noEditableSkills": "Tidak ada skill di {folder}/ yang diubah — skill nonaktif dilewati",
|
||||
|
||||
@@ -694,6 +694,8 @@
|
||||
"resources.folder.collapseAll": "すべて折りたたむ",
|
||||
"resources.folder.root": "ルート",
|
||||
"resources.folder.expandAll": "すべて展開",
|
||||
"resources.nested.one": "ネストされたスキル {count} 個",
|
||||
"resources.nested.other": "ネストされたスキル {count} 個",
|
||||
"resources.folder.expand": "{name} を展開",
|
||||
"resources.folder.collapse": "{name} を折りたたむ",
|
||||
"resources.folder.noEditableSkills": "{folder}/ のスキルは変更されませんでした — 無効なスキルはスキップされます",
|
||||
|
||||
@@ -694,6 +694,8 @@
|
||||
"resources.folder.collapseAll": "모두 접기",
|
||||
"resources.folder.root": "루트",
|
||||
"resources.folder.expandAll": "모두 펼치기",
|
||||
"resources.nested.one": "중첩 Skill {count}개",
|
||||
"resources.nested.other": "중첩 Skill {count}개",
|
||||
"resources.folder.expand": "{name} 펼치기",
|
||||
"resources.folder.collapse": "{name} 접기",
|
||||
"resources.folder.noEditableSkills": "{folder}/의 Skill이 변경되지 않았습니다 — 비활성화된 Skill은 건너뜁니다",
|
||||
|
||||
@@ -694,6 +694,8 @@
|
||||
"resources.folder.collapseAll": "Recolher Tudo",
|
||||
"resources.folder.root": "Raiz",
|
||||
"resources.folder.expandAll": "Expandir Tudo",
|
||||
"resources.nested.one": "{count} skill aninhado",
|
||||
"resources.nested.other": "{count} skills aninhados",
|
||||
"resources.folder.expand": "Expandir {name}",
|
||||
"resources.folder.collapse": "Recolher {name}",
|
||||
"resources.folder.noEditableSkills": "Nenhum skill em {folder}/ foi alterado — skills desativados são ignorados",
|
||||
|
||||
@@ -694,6 +694,8 @@
|
||||
"resources.folder.collapseAll": "全部折叠",
|
||||
"resources.folder.root": "根目录",
|
||||
"resources.folder.expandAll": "全部展开",
|
||||
"resources.nested.one": "{count} 个嵌套 skill",
|
||||
"resources.nested.other": "{count} 个嵌套 skill",
|
||||
"resources.folder.expand": "展开 {name}",
|
||||
"resources.folder.collapse": "收起 {name}",
|
||||
"resources.folder.noEditableSkills": "{folder}/ 中没有 skill 被更改 — 已禁用的 skill 会被跳过",
|
||||
|
||||
@@ -694,6 +694,8 @@
|
||||
"resources.folder.collapseAll": "全部收合",
|
||||
"resources.folder.root": "根目錄",
|
||||
"resources.folder.expandAll": "全部展開",
|
||||
"resources.nested.one": "{count} 個巢狀 skill",
|
||||
"resources.nested.other": "{count} 個巢狀 skill",
|
||||
"resources.folder.expand": "展開 {name}",
|
||||
"resources.folder.collapse": "收合 {name}",
|
||||
"resources.folder.noEditableSkills": "{folder}/ 中沒有 skill 被變更 — 已停用的 skill 會被略過",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
import { describe, expect, it } from 'vitest';
|
||||
import type { Skill } from '../api/client';
|
||||
import { groupByFolder, groupBySource, limitGroups, sortSkills } from './resourceGrouping';
|
||||
import { groupByFolder, groupBySource, limitGroups, nestSkills, nestedCount, sortSkills } from './resourceGrouping';
|
||||
|
||||
const skill = (relPath: string, extra: Partial<Skill> = {}): Skill => ({
|
||||
name: relPath.split('/').pop()!, kind: 'skill', flatName: relPath.replace(/\//g, '__'), relPath, sourcePath: '',
|
||||
@@ -60,3 +60,32 @@ describe('limitGroups', () => {
|
||||
expect(limitGroups(groups, 1, (g) => g.key === 'x').map((g) => g.items.map((s) => s.name))).toEqual([['a', 'b'], ['c']]);
|
||||
});
|
||||
});
|
||||
|
||||
describe('nestSkills', () => {
|
||||
const pack = [
|
||||
skill('visual-pack'),
|
||||
skill('visual-pack/skills/cover'),
|
||||
skill('visual-pack/skills/portrait'),
|
||||
skill('visual-pack/skills/portrait/skills/wardrobe'),
|
||||
skill('visual-pack-extra'),
|
||||
];
|
||||
|
||||
it('nests each skill under the nearest skill folder above it', () => {
|
||||
const { roots, children } = nestSkills(pack);
|
||||
|
||||
expect([roots.map((s) => s.relPath), [...children].map(([k, v]) => [k, v.map((s) => s.name)])]).toEqual([
|
||||
['visual-pack', 'visual-pack-extra'],
|
||||
[['visual-pack', ['cover', 'portrait']], ['visual-pack__skills__portrait', ['wardrobe']]],
|
||||
]);
|
||||
});
|
||||
|
||||
it('counts every descendant, not only direct children', () => {
|
||||
const { roots, children } = nestSkills(pack);
|
||||
|
||||
expect(nestedCount(roots[0], children)).toBe(3);
|
||||
});
|
||||
|
||||
it('keeps a child top-level when its parent is not in the list', () => {
|
||||
expect(nestSkills(pack.slice(1)).roots.map((s) => s.name)).toEqual(['cover', 'portrait', 'visual-pack-extra']);
|
||||
});
|
||||
});
|
||||
|
||||
@@ -158,6 +158,30 @@ export function limitGroups<G extends { items: Skill[] }>(groups: G[], limit: nu
|
||||
return out;
|
||||
}
|
||||
|
||||
/* -- Nested skills -------------------------------- */
|
||||
|
||||
export interface Nest { roots: Skill[]; children: Map<string, Skill[]> }
|
||||
|
||||
/** Puts each skill under the nearest skill in `items` whose folder holds it; both lists keep the order of `items`. */
|
||||
export function nestSkills(items: Skill[]): Nest {
|
||||
const byPath = new Map(items.map((s) => [s.relPath, s]));
|
||||
const roots: Skill[] = [];
|
||||
const children = new Map<string, Skill[]>();
|
||||
for (const s of items) {
|
||||
let parent: Skill | undefined;
|
||||
for (let i = s.relPath.lastIndexOf('/'); i > 0 && !parent; i = s.relPath.lastIndexOf('/', i - 1)) parent = byPath.get(s.relPath.slice(0, i));
|
||||
if (!parent) { roots.push(s); continue; }
|
||||
if (!children.has(parent.flatName)) children.set(parent.flatName, []);
|
||||
children.get(parent.flatName)!.push(s);
|
||||
}
|
||||
return { roots, children };
|
||||
}
|
||||
|
||||
/** How many skills sit anywhere under `s`. */
|
||||
export function nestedCount(s: Skill, children: Map<string, Skill[]>): number {
|
||||
return (children.get(s.flatName) ?? []).reduce((n, c) => n + 1 + nestedCount(c, children), 0);
|
||||
}
|
||||
|
||||
/** Splits target names into global tools and projects; `myapp@claude` is claude in the myapp project. */
|
||||
export function splitTargets(names: string[]): { global: string[]; projects: [string, string[]][] } {
|
||||
const global: string[] = [];
|
||||
|
||||
@@ -40,9 +40,9 @@ import { globToRegex } from '../lib/glob';
|
||||
import { parseRemoteURL } from '../lib/parseRemoteURL';
|
||||
import { folderOf, formatTrackedRepoName, resourceHref } from '../lib/resourceNames';
|
||||
import {
|
||||
byTargetOrProject, countLabel, groupByFolder, groupBySource, limitGroups, parentPath, projectOf, repoOf, sortSkills, sourceLinkOf, sourceName, splitTargets, syncedByTarget,
|
||||
byTargetOrProject, countLabel, groupByFolder, groupBySource, limitGroups, nestedCount, nestSkills, parentPath, projectOf, repoOf, sortSkills, sourceLinkOf, sourceName, splitTargets, syncedByTarget,
|
||||
SOURCE_LABEL, SOURCE_ORDER,
|
||||
type FolderGroup, type Group, type SortType, type SourceFilter,
|
||||
type FolderGroup, type Group, type Nest, type SortType, type SourceFilter,
|
||||
} from '../lib/resourceGrouping';
|
||||
import { useSyncMatrix } from '../hooks/useSyncMatrix';
|
||||
import { useRepoUpdate } from '../hooks/useRepoUpdate';
|
||||
@@ -108,6 +108,8 @@ const COLLAPSED_KEY = 'skillshare:folder-collapsed';
|
||||
const groupKey = (key: string) => `group:${key}`;
|
||||
/** A folder group's key, kept apart from source groups of the same name. */
|
||||
const folderKey = (key: string) => `f:${key}`;
|
||||
/** Packages start collapsed, so the collapsed set records the ones opened instead. */
|
||||
const openKey = (flatName: string) => `open:${flatName}`;
|
||||
/** Enable/disable toasts replace each other, so quick on/off clicks never leave an outdated one on screen. */
|
||||
const TOGGLE_TOAST = 'resource-toggle';
|
||||
|
||||
@@ -345,6 +347,10 @@ export default function ResourcesPage({ kind }: { kind: Kind }) {
|
||||
}
|
||||
return rows;
|
||||
}, [treeRows, limit]);
|
||||
// List view nests a skill under the nearest skill whose folder holds it, within the skill's group.
|
||||
const nests = useMemo(() => new Map<string, Nest>(view !== 'list' ? [] :
|
||||
(group === 'source' ? groups : group === 'folder' ? folderGroups : [{ key: '', items: filtered }]).map((g) => [g.key, nestSkills(g.items)])),
|
||||
[view, group, groups, folderGroups, filtered]);
|
||||
const byName = useMemo(() => new Map(items.map((s) => [s.flatName, s])), [items]);
|
||||
const treeSkills = useMemo(() => selectedSkills(tree, treeSel, byName), [tree, treeSel, byName]);
|
||||
const paneSubject = useMemo((): PaneSubject => {
|
||||
@@ -638,7 +644,7 @@ export default function ResourcesPage({ kind }: { kind: Kind }) {
|
||||
</div>
|
||||
);
|
||||
|
||||
const itemRow = (s: Skill) => {
|
||||
const itemRow = (s: Skill, depth = 0, pkg?: { count: number; open: boolean }) => {
|
||||
const { synced, reachable, tone, label } = rowInfo(s);
|
||||
// Grouped by folder, the header already names the parent path.
|
||||
const sub = group === 'folder' && !s.linkName ? '' : parentPath(s, group === 'source' || group === 'folder');
|
||||
@@ -650,10 +656,16 @@ export default function ResourcesPage({ kind }: { kind: Kind }) {
|
||||
onContextMenu={(e) => openItemMenu(e, s)}
|
||||
>
|
||||
{selectBox(s)}
|
||||
<span className="flex flex-col min-w-0 flex-1 gap-px">
|
||||
<span className="flex flex-col min-w-0 flex-1 gap-px" style={depth ? { paddingLeft: depth * 24 } : undefined}>
|
||||
<span className="flex min-w-0 items-center gap-2">
|
||||
{pkg && (
|
||||
<button type="button" className="ss-ib !w-6 !h-6 -mx-1 shrink-0" aria-expanded={pkg.open} aria-label={t(pkg.open ? 'resources.folder.collapse' : 'resources.folder.expand', { name: s.name })} onClick={() => toggleCollapsed(openKey(s.flatName))}>
|
||||
{pkg.open ? <ChevronDown size={15} /> : <ChevronRight size={15} />}
|
||||
</button>
|
||||
)}
|
||||
<Link to={resourceHref(s)} className={`nm m truncate hover:underline ${s.disabled ? 'text-ink-3' : ''}`}>{s.name}</Link>
|
||||
{s.manualOnly && <span className="ss-tag shrink-0" title={t('frontmatterEditor.field.disableModelInvocation.hint')}>manual only</span>}
|
||||
{pkg && <span className="shrink-0 text-xs text-ink-3">{t(plural('resources.nested', pkg.count), { count: pkg.count })}</span>}
|
||||
</span>
|
||||
{sub && <span className="font-mono text-xs text-ink-3 truncate">{sub}</span>}
|
||||
</span>
|
||||
@@ -665,6 +677,15 @@ export default function ResourcesPage({ kind }: { kind: Kind }) {
|
||||
);
|
||||
};
|
||||
|
||||
/** A package row, then its nested skills while it is open. */
|
||||
const nestRows = (list: Skill[], nest: Nest | undefined, depth = 0): React.ReactNode[] => list.flatMap((s) => {
|
||||
const kids = nest?.children.get(s.flatName);
|
||||
if (!kids) return [itemRow(s, depth)];
|
||||
// Filtering opens every package so nested matches stay visible, as the tree view does.
|
||||
const open = filtering || collapsed.has(openKey(s.flatName));
|
||||
return [itemRow(s, depth, { count: nestedCount(s, nest!.children), open }), ...(open ? nestRows(kids, nest, depth + 1) : [])];
|
||||
});
|
||||
|
||||
const card = (s: Skill) => {
|
||||
const { synced, reachable, tone, label } = rowInfo(s);
|
||||
return (
|
||||
@@ -694,10 +715,14 @@ export default function ResourcesPage({ kind }: { kind: Kind }) {
|
||||
/* -- Content -- */
|
||||
|
||||
const treeItemTotal = treeRows.filter((r) => r.type === 'item').length;
|
||||
// List view hides a collapsed group's rows, so they neither page nor count as shown.
|
||||
// List view pages top-level rows; a collapsed group's rows neither page nor count as shown.
|
||||
const listGroups = view !== 'list' ? [] : group === 'source' ? groups : group === 'folder' ? folderGroups : [];
|
||||
const groupHidden = (g: { key: string }) => collapsed.has(groupKey(group === 'folder' ? folderKey(g.key) : g.key));
|
||||
const total = view === 'tree' ? treeItemTotal : filtered.length - listGroups.filter(groupHidden).reduce((n, g) => n + g.items.length, 0);
|
||||
const roots = (key: string) => nests.get(key)?.roots ?? [];
|
||||
const total = view === 'tree' ? treeItemTotal
|
||||
: view !== 'list' ? filtered.length
|
||||
: group === 'none' ? roots('').length
|
||||
: listGroups.filter((g) => !groupHidden(g)).reduce((n, g) => n + roots(g.key).length, 0);
|
||||
const shown = Math.min(limit, total);
|
||||
let content: React.ReactNode;
|
||||
|
||||
@@ -827,13 +852,20 @@ export default function ResourcesPage({ kind }: { kind: Kind }) {
|
||||
</div>
|
||||
);
|
||||
let body: React.ReactNode;
|
||||
const rows = (key: string, list: Skill[]) => (collapsed.has(groupKey(key)) ? [] : list.map((s) => itemRow(s)));
|
||||
// Pages each group's top-level rows; the head still counts every skill in the group.
|
||||
const paged = <G extends { key: string; items: Skill[] }>(list: G[], head: (g: G) => React.ReactNode) => {
|
||||
const byKey = new Map(list.map((g) => [g.key, g]));
|
||||
return limitGroups(list.map((g) => ({ ...g, items: roots(g.key) })), limit, groupHidden).map((p) => [
|
||||
head(byKey.get(p.key)!),
|
||||
...(groupHidden(p) ? [] : nestRows(p.items, nests.get(p.key))),
|
||||
]);
|
||||
};
|
||||
if (group === 'source') {
|
||||
body = limitGroups(groups, limit, groupHidden).map((g) => [groupHead(g, false), ...rows(g.key, g.items)]);
|
||||
body = paged(groups, (g) => groupHead(g, false));
|
||||
} else if (group === 'folder') {
|
||||
body = limitGroups(folderGroups, limit, groupHidden).map((g) => [folderHead(g, false), ...rows(folderKey(g.key), g.items)]);
|
||||
body = paged(folderGroups, (g) => folderHead(g, false));
|
||||
} else {
|
||||
body = <>{groups.filter((g) => g.link && g.items.length === 0).map((g) => groupHead(g, false))}{filtered.slice(0, limit).map((s) => itemRow(s))}</>;
|
||||
body = <>{groups.filter((g) => g.link && g.items.length === 0).map((g) => groupHead(g, false))}{nestRows(roots('').slice(0, limit), nests.get(''))}</>;
|
||||
}
|
||||
content = <div className="ss-list stick">{header}{body}</div>;
|
||||
}
|
||||
|
||||
@@ -90,7 +90,7 @@ Some pages show a count in the sidebar when they need attention. The counts refr
|
||||
| **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. Targets that get the same changes share one card that lists the skills by folder. **Discard all** moves skills that no target has received yet to the trash, after a confirmation. When a target's `include` filter matches no skill, a notice says the target gets no skills, and **Edit filter** opens the place where that filter is set; Git Sync shows the same notice after a pull |
|
||||
| **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. When both computers have new commits, **Pull and merge** preserves both histories before you push. With uncommitted changes and remote updates, **Commit and pull** saves your changes first. Pull syncs what the repo scope holds (`skills`, `agents`, `extras`, or `root`), like [`pull`](/docs/reference/commands/pull). **Sync both ways** commits local changes, pulls and merges, syncs targets, then pushes, like [`push --pull`](/docs/reference/commands/push#push-and-pull-together); a conflict stops it before pushing. Conflicting files open a version comparison; choose the local or remote version of each whole file (or keep all local or all remote at once), then **Apply choices and pull**. Cancel leaves your files unchanged. 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. 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; its menu also holds **New skill**, which opens the creation wizard, and **Link folder**. When the config lists entries that are not installed, the **Updates** tab and the install dialog offer **Install all**, like a bare [`install`](/docs/reference/commands/install). After a check, skills deleted from their source repo are listed with **Prune** and **Prune all**, which move them to the trash. **Link folder** links a folder into the skills source like [`link`](/docs/reference/commands/link): it takes a path, an optional link name and, while `follow_source_links` is off, a checkbox that turns it on, and a refused folder shows the same reason as the command. A linked folder is listed as its own group with the link icon and the folder it points at; the icon button on its row (the link icon turns into an unlink icon on hover) asks for confirmation and then unlinks it like [`unlink`](/docs/reference/commands/unlink): the folder is not touched and the link can be restored from the **Trash** tab. A skill inside a linked folder can still be uninstalled on its own, which moves it out of that folder to the trash; linked folders have no **Update repo** or **Uninstall repo**. 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 (an item that a `!` rule in `.skillignore.local` keeps on is reported as failed, with the reason), 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. The file browser lists `SKILL.md` and attachments through followed source links, including when the link itself is the skill root. |
|
||||
| **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; its menu also holds **New skill**, which opens the creation wizard, and **Link folder**. When the config lists entries that are not installed, the **Updates** tab and the install dialog offer **Install all**, like a bare [`install`](/docs/reference/commands/install). After a check, skills deleted from their source repo are listed with **Prune** and **Prune all**, which move them to the trash. **Link folder** links a folder into the skills source like [`link`](/docs/reference/commands/link): it takes a path, an optional link name and, while `follow_source_links` is off, a checkbox that turns it on, and a refused folder shows the same reason as the command. A linked folder is listed as its own group with the link icon and the folder it points at; the icon button on its row (the link icon turns into an unlink icon on hover) asks for confirmation and then unlinks it like [`unlink`](/docs/reference/commands/unlink): the folder is not touched and the link can be restored from the **Trash** tab. A skill inside a linked folder can still be uninstalled on its own, which moves it out of that folder to the trash; linked folders have no **Update repo** or **Uninstall repo**. 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. In the list view, a skill inside another skill's folder is listed under that skill, which starts collapsed and shows how many nested skills it holds; a search opens every package, and paging counts only top-level rows. 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 (an item that a `!` rule in `.skillignore.local` keeps on is reported as failed, with the reason), 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. The file browser lists `SKILL.md` and attachments through followed source links, including when the link itself is the skill root. |
|
||||
| **Extras** | **Folders & files**: rules, commands, and other files synced alongside skills. **Edit target** changes a target's folder, file name, mode, flatten setting and [file filters](./extras.md#choosing-files) with a preview; **Edit extra** renames an extra or points it at another source folder. **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). **Memory**: browse, search, preview, edit, and delete shared Markdown notes; add INDEX links, preserve drafts on conflicts, open Backup Files history, and connect agents through reviewed instruction-file changes. Configured status does not prove a read. See the [Memory walkthrough](../../how-to/daily-tasks/sharing-memory.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**. The server dialog's **Tools** section sets the [tool policy](./mcp.md#tool-policy): **Load tools**, which starts the server once with the dialog's settings, saved or not, and lists its tools to tick; an **Exclude rules** row for `*` patterns; it lists each selected Agent that does not apply part of the policy, and the row shows a tag when a policy is set. For a Pi server, the dialog also has [Pi's built-in MCP](./mcp.md#pi) settings: tool exposure and other Pi settings, which take [`piOptions`](./mcp.md#pi-options) as JSON, with their help in info tooltips. **Defaults** edits `mcp.targets`. **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. |
|
||||
| **Plugins** | One row per plugin, with its Agents as toggles. Expanding a row also lists the other Agents the source supports; ticking one previews an install. The row menu syncs, updates, removes, or opens **View files**, a read-only browser of the local copy Skillshare reviewed. **Share** copies one command that adds the ticked plugins from their HTTPS sources. See [Manage plugins across tools](/docs/how-to/daily-tasks/sharing-plugins) |
|
||||
|
||||
@@ -90,7 +90,7 @@ skillshare ui start --clear-cache
|
||||
| **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 が表示される。同じ変更を受け取る Target は 1 枚のカードにまとめられ、Skill がフォルダごとに並ぶ。**Discard all** は確認のあと、まだどの Target にも届いていない Skill をゴミ箱に移す。Target の `include` フィルターがどの Skill にも一致しないときは、その Target に Skill が届かないことを知らせる通知が表示され、**Edit filter** でそのフィルターを設定している場所を開ける。Git Sync でも pull のあとに同じ通知が表示される |
|
||||
| **Git Sync** | Source リポジトリのコミットとプッシュ、remote にまだないコミットのプッシュ、プルを実行。ページを開くと remote から fetch するため、**Pull** には remote にあるコミット数が表示される。プルはリポジトリのスコープ(`skills`、`agents`、`extras`、または `root`)が保持するものを sync する。詳細は [`pull`](/docs/reference/commands/pull) を参照。**Sync both ways** はローカルの変更をコミットし、プルしてマージし、target を sync してからプッシュする([`push --pull`](/docs/reference/commands/push#push-and-pull-together) と同じ)。コンフリクトが発生した場合はプッシュ前に停止する。remote に新しいコミットがあるためにプッシュが拒否された場合、エラーに **Pull** が表示される。最初のプルが remote とマージできない場合、remote ブランチでローカルファイルを置き換える force pull を提案する |
|
||||
| **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** と **Link folder** もある。config にまだインストールされていないエントリがあるときは、**Updates** タブとインストールダイアログに **Install all** が表示され、引数なしの [`install`](/docs/reference/commands/install) と同じように動く。チェックのあと、ソース repo から削除された Skill が **Prune** と **Prune all** 付きで表示され、ゴミ箱に移せる。**Link folder** は [`link`](/docs/reference/commands/link) と同様にフォルダを Skill の source にリンクする。パス、任意のリンク名、`follow_source_links` が無効の間はそれを有効にするチェックボックスを受け付け、拒否されたフォルダにはコマンドと同じ理由を表示する。リンクしたフォルダはリンクアイコンとリンク先フォルダ付きの独立したグループとして表示される。その行のアイコンボタン(ホバーするとリンクアイコンがリンク解除アイコンに変わる)は確認後、[`unlink`](/docs/reference/commands/unlink) と同様にリンクを解除する。フォルダ自体には触れず、リンクは **Trash** タブから復元できる。リンクしたフォルダ内の Skill は個別にアンインストールでき、そのフォルダから trash へ移動される。リンクしたフォルダには **Update repo** と **Uninstall repo** はない。一覧とカードビューは **Folder**(tracked repo、`frontend/react` のようなフォルダ、または **Root**)でフィルタでき、**Folder** でグループ化もできる。Root が先頭で、残りのフォルダは名前の A→Z 順。**tree** ビューは左に source のフォルダ、右に詳細を表示する。フォルダや Skill をクリックして選択し、Cmd/Ctrl クリックで選択に追加、Shift クリックで範囲選択、Skill をダブルクリックで開く。右側では、選択したものすべてを 1 つのスイッチで有効・無効にし(`.skillignore.local` の `!` ルールが有効のまま保つ項目は、理由とともに失敗として報告されます)、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** からも同じダイアログが開く。ファイルブラウザーは、たどられた source リンク自体が Skill のルートである場合も、そのリンクを通して `SKILL.md` と添付ファイルを一覧表示します。 |
|
||||
| **Skills** / **Agents** | インストール済みの項目、**Updates** タブ、**Trash** タブ。Skills にはさらに、Target のコンテキストに Skill が追加するトークン数を見積もる **Analyze** タブがある。**Install** は GitHub を検索するか、URL やパスからインストールする。メニューには作成ウィザードを開く **New skill** と **Link folder** もある。config にまだインストールされていないエントリがあるときは、**Updates** タブとインストールダイアログに **Install all** が表示され、引数なしの [`install`](/docs/reference/commands/install) と同じように動く。チェックのあと、ソース repo から削除された Skill が **Prune** と **Prune all** 付きで表示され、ゴミ箱に移せる。**Link folder** は [`link`](/docs/reference/commands/link) と同様にフォルダを Skill の source にリンクする。パス、任意のリンク名、`follow_source_links` が無効の間はそれを有効にするチェックボックスを受け付け、拒否されたフォルダにはコマンドと同じ理由を表示する。リンクしたフォルダはリンクアイコンとリンク先フォルダ付きの独立したグループとして表示される。その行のアイコンボタン(ホバーするとリンクアイコンがリンク解除アイコンに変わる)は確認後、[`unlink`](/docs/reference/commands/unlink) と同様にリンクを解除する。フォルダ自体には触れず、リンクは **Trash** タブから復元できる。リンクしたフォルダ内の Skill は個別にアンインストールでき、そのフォルダから trash へ移動される。リンクしたフォルダには **Update repo** と **Uninstall repo** はない。一覧とカードビューは **Folder**(tracked repo、`frontend/react` のようなフォルダ、または **Root**)でフィルタでき、**Folder** でグループ化もできる。Root が先頭で、残りのフォルダは名前の A→Z 順。リストビューでは、別のスキルのフォルダ内にあるスキルはそのスキルの下に表示されます。親の行は最初は折りたたまれ、ネストされたスキルの数を表示します。検索中はすべて展開され、ページ送りは最上位の行だけを数えます。**tree** ビューは左に source のフォルダ、右に詳細を表示する。フォルダや Skill をクリックして選択し、Cmd/Ctrl クリックで選択に追加、Shift クリックで範囲選択、Skill をダブルクリックで開く。右側では、選択したものすべてを 1 つのスイッチで有効・無効にし(`.skillignore.local` の `!` ルールが有効のまま保つ項目は、理由とともに失敗として報告されます)、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** からも同じダイアログが開く。ファイルブラウザーは、たどられた source リンク自体が Skill のルートである場合も、そのリンクを通して `SKILL.md` と添付ファイルを一覧表示します。 |
|
||||
| **Extras** | **フォルダー**: Skill と一緒に sync される rules、commands、その他のフォルダ。**Edit target** で Target のフォルダ、ファイル名、モード、flatten、[ファイルフィルター](./extras.md#choosing-files)をプレビューしながら変更できる。**Edit extra** で Extra の名前を変えたり、別のソースフォルダを指定したりできる。**AGENTS.md**: global モードでは共有 `AGENTS.md` と、それを使う Target。Project では Project の `./AGENTS.md` と、各 Target がそれを読み込めるか。[1 つの AGENTS.md をツール間で共有する](../../how-to/daily-tasks/sharing-instructions.md)を参照 **Memory**: [メモリ共有ガイド](../../how-to/daily-tasks/sharing-memory.md)(英語スクリーンショット)。ノートの検索、プレビュー、編集、削除、INDEX リンク、競合時の下書き保持、Backup Files の履歴と復元、**Connect to agents** → **Review changes** → **Apply changes**。設定状態は読み取り済みを示しません |
|
||||
| **MCP** | サーバーごとに 1 行表示され、sync 先の Agent がチップとして並び、行のカウントボタンでそれらのトグルを開く。**サーバーを追加** は URL、コマンド、貼り付けたスニペット、またはファイルを受け付ける。**target からインポート** はインストール済みの Agent が既に持っているものを読み込む。各サーバーのメニューには **各 Agent に書き込まれる設定を表示** があり、source とすべての Agent のファイルを一覧表示し、選んだものを未保存の編集を含めて表示する。コンフリクトでは **その Agent からインポート** か **ソースで上書き** を選べる。サーバーのダイアログの **ツール** セクションでは [ツールポリシー](./mcp.md#tool-policy) を設定する。保存済みかどうかに関係なくダイアログの現在の設定でサーバーを一度起動し、ツールをチェックできる一覧にする **ツールを読み込む**、`*` パターン用の **除外ルール** の行がある。ポリシーの一部を適用しない選択中の Agent がそれぞれ表示され、ポリシーを設定すると行にタグが付く。Pi サーバーでは、ダイアログに [Pi の内蔵 MCP](./mcp.md#pi) の設定もあり、ツールの公開方法とその他の Pi 設定を扱い、後者は [`piOptions`](./mcp.md#pi-options) を JSON で受け付ける。説明は情報アイコンのツールチップに表示される。**デフォルト** は `mcp.targets` を編集する。Sync ボックスの **Sync MCP** は保留中の変更を一覧表示し、MCP の設定ファイルだけを書き込み、それぞれのバックアップを保存する。その下では [**チェック**](./mcp.md#check-servers-before-an-agent-starts-them) がサーバーをチェックし、**バックアップと復元** でそれらのバックアップをプレビューして復元できる。 |
|
||||
| **Plugins** | Plugin ごとに 1 行表示され、その Agent がトグルとして並ぶ。行を展開すると、そのソースが対応する他の Agent も一覧され、いずれかにチェックを入れるとインストールのプレビューが表示される。行のメニューから sync、update、削除ができ、Skillshare がレビューしたローカルコピーを読み取り専用で閲覧する **View files** も開ける。[Manage plugins across tools](/docs/how-to/daily-tasks/sharing-plugins) を参照 |
|
||||
|
||||
@@ -90,7 +90,7 @@ skillshare ui start --clear-cache
|
||||
| **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이 표시됩니다. 같은 변경을 받는 target들은 한 카드로 묶이고 skill이 폴더별로 나열됩니다. **Discard all**은 확인 후, 아직 어떤 target에도 전달되지 않은 skill을 휴지통으로 옮깁니다. target의 `include` 필터가 어떤 skill과도 일치하지 않으면 그 target이 skill을 하나도 받지 못한다는 알림이 표시되고, **Edit filter**로 그 필터를 설정하는 곳을 열 수 있습니다. Git Sync도 pull 후에 같은 알림을 표시합니다 |
|
||||
| **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`)을 동기화합니다. **Sync both ways**는 로컬 변경 사항을 commit하고, pull해 병합하고, target을 동기화한 뒤 push합니다([`push --pull`](/docs/reference/commands/push#push-and-pull-together)과 같음). 충돌이 발생하면 push하기 전에 멈춥니다. remote에 더 새로운 커밋이 있어 push가 거부되면 오류 알림에서 **Pull**을 제공합니다. 첫 pull이 remote와 병합할 수 없을 때는 로컬 파일을 remote 브랜치로 교체하는 force pull을 제공합니다 |
|
||||
| **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**과 **Link folder**도 있습니다. config에 아직 설치되지 않은 항목이 있으면 **Updates** 탭과 설치 대화 상자에 **Install all**이 표시되며, 인자 없는 [`install`](/docs/reference/commands/install)과 같이 동작합니다. 확인을 실행한 후에는 소스 repo에서 삭제된 skill이 **Prune**, **Prune all**과 함께 표시되어 휴지통으로 옮길 수 있습니다. **Link folder**는 [`link`](/docs/reference/commands/link)처럼 폴더를 skills source에 링크합니다. 경로, 선택적인 링크 이름, 그리고 `follow_source_links`가 꺼져 있는 동안에는 이를 켜는 체크박스를 받으며, 거부된 폴더에는 명령과 같은 이유를 표시합니다. 링크된 폴더는 링크 아이콘과 가리키는 폴더가 표시된 별도 그룹으로 나열됩니다. 그 행의 아이콘 버튼(마우스를 올리면 링크 아이콘이 링크 해제 아이콘으로 바뀜)은 확인을 거친 뒤 [`unlink`](/docs/reference/commands/unlink)처럼 링크를 해제합니다. 폴더 자체는 건드리지 않으며 링크는 **Trash** 탭에서 복원할 수 있습니다. 링크된 폴더 안의 skill은 개별로 제거할 수 있으며, 그 폴더에서 trash로 옮겨집니다. 링크된 폴더에는 **Update repo**와 **Uninstall repo**가 없습니다. 목록과 카드 보기는 **Folder**(tracked repo, `frontend/react` 같은 폴더, 또는 **Root**)로 필터링하고 **Folder**로 그룹화할 수 있으며, Root가 먼저 오고 나머지 폴더는 이름 A→Z 순입니다. **tree** 보기는 왼쪽에 source 폴더를, 오른쪽에 상세 정보를 보여 줍니다. 폴더나 skill을 클릭해 선택하고, Cmd/Ctrl 클릭으로 선택에 추가하고, Shift 클릭으로 범위를 선택하며, skill을 더블클릭하면 열립니다. 오른쪽에서는 선택한 모든 항목을 스위치 하나로 켜거나 끄고(`.skillignore.local`의 `!` 규칙이 켜 둔 채로 유지하는 항목은 이유와 함께 실패로 보고됩니다), 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**에서 같은 대화상자가 열립니다. 파일 브라우저는 연결된 source 링크 자체가 skill의 루트인 경우에도 링크를 통해 `SKILL.md`와 첨부 파일을 나열합니다. |
|
||||
| **Skills** / **Agents** | 설치된 항목, **Updates** 탭, **Trash** 탭. Skills에는 각 skill이 target의 context에 추가하는 토큰 수를 추정하는 **Analyze** 탭도 있습니다. **Install**은 GitHub를 검색하거나 URL 또는 경로에서 설치합니다. 메뉴에는 생성 마법사를 여는 **New skill**과 **Link folder**도 있습니다. config에 아직 설치되지 않은 항목이 있으면 **Updates** 탭과 설치 대화 상자에 **Install all**이 표시되며, 인자 없는 [`install`](/docs/reference/commands/install)과 같이 동작합니다. 확인을 실행한 후에는 소스 repo에서 삭제된 skill이 **Prune**, **Prune all**과 함께 표시되어 휴지통으로 옮길 수 있습니다. **Link folder**는 [`link`](/docs/reference/commands/link)처럼 폴더를 skills source에 링크합니다. 경로, 선택적인 링크 이름, 그리고 `follow_source_links`가 꺼져 있는 동안에는 이를 켜는 체크박스를 받으며, 거부된 폴더에는 명령과 같은 이유를 표시합니다. 링크된 폴더는 링크 아이콘과 가리키는 폴더가 표시된 별도 그룹으로 나열됩니다. 그 행의 아이콘 버튼(마우스를 올리면 링크 아이콘이 링크 해제 아이콘으로 바뀜)은 확인을 거친 뒤 [`unlink`](/docs/reference/commands/unlink)처럼 링크를 해제합니다. 폴더 자체는 건드리지 않으며 링크는 **Trash** 탭에서 복원할 수 있습니다. 링크된 폴더 안의 skill은 개별로 제거할 수 있으며, 그 폴더에서 trash로 옮겨집니다. 링크된 폴더에는 **Update repo**와 **Uninstall repo**가 없습니다. 목록과 카드 보기는 **Folder**(tracked repo, `frontend/react` 같은 폴더, 또는 **Root**)로 필터링하고 **Folder**로 그룹화할 수 있으며, Root가 먼저 오고 나머지 폴더는 이름 A→Z 순입니다. 목록 보기에서는 다른 skill의 폴더 안에 있는 skill이 그 skill 아래에 표시됩니다. 상위 행은 처음에 접혀 있고 중첩된 skill 수를 보여 주며, 검색하면 모두 펼쳐지고 페이지 나눔은 최상위 행만 셉니다. **tree** 보기는 왼쪽에 source 폴더를, 오른쪽에 상세 정보를 보여 줍니다. 폴더나 skill을 클릭해 선택하고, Cmd/Ctrl 클릭으로 선택에 추가하고, Shift 클릭으로 범위를 선택하며, skill을 더블클릭하면 열립니다. 오른쪽에서는 선택한 모든 항목을 스위치 하나로 켜거나 끄고(`.skillignore.local`의 `!` 규칙이 켜 둔 채로 유지하는 항목은 이유와 함께 실패로 보고됩니다), 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**에서 같은 대화상자가 열립니다. 파일 브라우저는 연결된 source 링크 자체가 skill의 루트인 경우에도 링크를 통해 `SKILL.md`와 첨부 파일을 나열합니다. |
|
||||
| **Extras** | **폴더**: skill과 함께 동기화되는 rules, commands, 기타 폴더. **Edit target**으로 target의 폴더, 파일 이름, 모드, flatten 설정, [파일 필터](./extras.md#choosing-files)를 미리 보며 바꿀 수 있고, **Edit extra**로 extra 이름을 바꾸거나 다른 소스 폴더를 가리키게 할 수 있습니다. **AGENTS.md**: global 모드에서는 공유 `AGENTS.md`와 그것을 쓰는 target, 프로젝트에서는 프로젝트의 `./AGENTS.md`와 각 target이 그것을 읽는지 여부. [여러 도구에서 하나의 AGENTS.md 공유하기](../../how-to/daily-tasks/sharing-instructions.md)를 참고하세요 **Memory**: [메모리 공유 가이드](../../how-to/daily-tasks/sharing-memory.md)(영어 스크린샷). 노트 검색, 미리 보기, 편집, 삭제, INDEX 링크, 충돌 시 초안 보존, Backup Files 기록과 복원, **Connect to agents** → **Review changes** → **Apply changes**. 설정 상태는 읽기를 증명하지 않습니다 |
|
||||
| **MCP** | 서버당 한 행이며, 동기화 대상인 Agent가 chip으로 표시되며, 행의 카운트 버튼을 누르면 해당 토글이 열립니다. **서버 추가**는 URL, command, 붙여넣은 snippet 또는 파일을 받습니다. **target에서 가져오기**는 설치된 Agent가 이미 가지고 있는 것을 읽어옵니다. 각 서버의 메뉴에는 **각 Agent에 기록될 설정 보기**가 있어 source와 모든 Agent의 파일을 나열하고, 선택한 파일을 저장되지 않은 편집을 포함해 보여줍니다. 충돌 시 **해당 Agent에서 가져오기** 또는 **원본으로 덮어쓰기**를 제공합니다. 서버 대화상자의 **도구** 섹션은 [도구 정책](./mcp.md#tool-policy)을 설정합니다: 저장 여부와 관계없이 대화상자의 현재 설정으로 서버를 한 번 시작해 도구를 선택할 수 있는 목록으로 보여 주는 **도구 불러오기**, `*` 패턴용 **제외 규칙** 행이 있습니다. 이 섹션은 정책 일부를 적용하지 않는 선택된 Agent를 각각 나열하며, 정책이 설정되면 행에 태그가 표시됩니다. Pi 서버의 경우, 대화상자에는 [Pi 내장 MCP](./mcp.md#pi) 설정도 있습니다: 도구 노출 방식과 기타 Pi 설정이며, 이 설정은 [`piOptions`](./mcp.md#pi-options)를 JSON으로 받고 도움말은 정보 툴팁에 있습니다. **기본값**은 `mcp.targets`를 편집합니다. Sync 박스의 **Sync MCP**는 대기 중인 변경 사항을 나열하고 MCP 설정 파일만 작성하며, 각 파일의 백업을 남깁니다. 그 아래에서 [**검사**](./mcp.md#check-servers-before-an-agent-starts-them)는 서버를 검사하고, **백업 및 복원**는 그 백업을 미리 보고 복원합니다. |
|
||||
| **Plugins** | plugin당 한 행이며, 해당 Agent가 토글로 표시됩니다. 행을 펼치면 소스가 지원하는 다른 Agent도 나열되며, 하나를 선택하면 설치를 미리 봅니다. 행 메뉴는 sync, update, remove를 수행하거나, Skillshare가 검토한 로컬 사본을 읽기 전용으로 탐색하는 **View files**를 엽니다. [Manage plugins across tools](/docs/how-to/daily-tasks/sharing-plugins) 참고 |
|
||||
|
||||
+1
-1
@@ -90,7 +90,7 @@ skillshare ui start --clear-cache
|
||||
| **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。收到相同变更的 Target 会合并成一张卡片,按文件夹列出 skills。**Discard all** 会在确认后,把还没有任何 Target 收到的 skills 移到回收站。当某个 Target 的 `include` 过滤条件没有匹配任何 skill 时,会显示提示说明该 Target 收不到任何 skill,**Edit filter** 会打开设置该过滤条件的地方;Git Sync 在 pull 之后也会显示同样的提示 |
|
||||
| **Git Sync** | 提交并推送 source 仓库,推送尚未上 remote 的提交,并拉取。打开页面时会先从 remote fetch,所以 **Pull** 会显示 remote 有多少个新提交。Pull 会同步该仓库 scope 所涵盖的内容(`skills`、`agents`、`extras` 或 `root`),与 [`pull`](/docs/reference/commands/pull) 相同。**Sync both ways** 会提交本地更改、拉取并合并、同步 targets,然后推送,与 [`push --pull`](/docs/reference/commands/push#push-and-pull-together) 相同;遇到冲突时会在推送前停止。当 remote 因为有更新的提交而拒绝 push 时,错误提示会提供 **Pull**。当首次 pull 无法与 remote 合并时,它会提供一个强制 pull 选项,用 remote 分支替换本地文件 |
|
||||
| **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** 和 **Link folder**。config 中有尚未安装的条目时,**Updates** 标签页和安装对话框会提供 **Install all**,效果同不带参数的 [`install`](/docs/reference/commands/install)。执行检查后,已从来源 repo 删除的 skills 会列出并提供 **Prune** 和 **Prune all**,把它们移到回收站。**Link folder** 与 [`link`](/docs/reference/commands/link) 一样把文件夹链接到 skills Source:填写路径、可选的链接名,`follow_source_links` 关闭时还有一个开启它的复选框;被拒绝的文件夹会显示与命令相同的原因。链接的文件夹会以独立分组列出,带有链接图标和它指向的文件夹;该行的图标按钮(悬停时链接图标变为取消链接图标)会先确认,再像 [`unlink`](/docs/reference/commands/unlink) 一样取消链接:文件夹本身不受影响,链接可以从 **Trash** 标签页恢复。链接文件夹里的 skill 仍可单独卸载,它会从该文件夹移到 trash;链接的文件夹没有 **Update repo** 和 **Uninstall repo**。列表和卡片视图可以按 **Folder**(tracked repo、`frontend/react` 这类文件夹,或 **Root**)过滤,也可以按 **Folder** 分组,Root 排在最前,其余文件夹按名称 A→Z 排序。**tree** 视图左侧显示 source 文件夹,右侧显示详情:点击文件夹或 skill 进行选择,Cmd/Ctrl 点击加入选择,Shift 点击选择范围,双击 skill 打开它。右侧可以用一个开关启用或停用所有选中的项目(被 `.skillignore.local` 的 `!` 规则保持启用的项目会报告为失败并附上原因)、设置它们的 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** 也会打开同一个对话框。文件浏览器会通过被跟随的 source 链接列出 `SKILL.md` 和附件,包括链接本身就是 skill 根目录的情况。 |
|
||||
| **Skills** / **Agents** | 已安装的项目、**Updates** 标签页,以及 **Trash** 标签页。Skills 还有一个 **Analyze** 标签页,估算每个 skill 为某个 target 的上下文增加了多少 token。**Install** 可从 GitHub 搜索,或从 URL 或路径安装。菜单里还有打开创建向导的 **New skill** 和 **Link folder**。config 中有尚未安装的条目时,**Updates** 标签页和安装对话框会提供 **Install all**,效果同不带参数的 [`install`](/docs/reference/commands/install)。执行检查后,已从来源 repo 删除的 skills 会列出并提供 **Prune** 和 **Prune all**,把它们移到回收站。**Link folder** 与 [`link`](/docs/reference/commands/link) 一样把文件夹链接到 skills Source:填写路径、可选的链接名,`follow_source_links` 关闭时还有一个开启它的复选框;被拒绝的文件夹会显示与命令相同的原因。链接的文件夹会以独立分组列出,带有链接图标和它指向的文件夹;该行的图标按钮(悬停时链接图标变为取消链接图标)会先确认,再像 [`unlink`](/docs/reference/commands/unlink) 一样取消链接:文件夹本身不受影响,链接可以从 **Trash** 标签页恢复。链接文件夹里的 skill 仍可单独卸载,它会从该文件夹移到 trash;链接的文件夹没有 **Update repo** 和 **Uninstall repo**。列表和卡片视图可以按 **Folder**(tracked repo、`frontend/react` 这类文件夹,或 **Root**)过滤,也可以按 **Folder** 分组,Root 排在最前,其余文件夹按名称 A→Z 排序。列表视图中,位于另一个 skill 文件夹里的 skill 会列在那个 skill 下方;父行默认折叠并显示嵌套 skill 的数量,搜索时全部展开,分页只计算顶层的行。**tree** 视图左侧显示 source 文件夹,右侧显示详情:点击文件夹或 skill 进行选择,Cmd/Ctrl 点击加入选择,Shift 点击选择范围,双击 skill 打开它。右侧可以用一个开关启用或停用所有选中的项目(被 `.skillignore.local` 的 `!` 规则保持启用的项目会报告为失败并附上原因)、设置它们的 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** 也会打开同一个对话框。文件浏览器会通过被跟随的 source 链接列出 `SKILL.md` 和附件,包括链接本身就是 skill 根目录的情况。 |
|
||||
| **Extras** | **文件夹**:与 skills 一起同步的 rules、commands 和其他目录。**Edit target** 可修改 Target 的文件夹、文件名、模式、flatten 设置和[文件过滤](./extras.md#choosing-files),并实时预览;**Edit extra** 可重命名 extra,或改为指向另一个来源文件夹。**AGENTS.md**:在 global mode 下是共享 `AGENTS.md` 以及哪些 target 在使用它们;在项目中是项目的 `./AGENTS.md` 以及每个 target 是否会读取它。参见[让多个工具共用一份 AGENTS.md](../../how-to/daily-tasks/sharing-instructions.md) **Memory**: [记忆共享教程](../../how-to/daily-tasks/sharing-memory.md)(英文截图)。搜索、预览、编辑、删除笔记、INDEX 链接、冲突时保留草稿、Backup Files 历史与恢复,以及 **Connect to agents** → **Review changes** → **Apply changes**;配置状态不代表已读取 |
|
||||
| **MCP** | 每个 server 一行,并以 chip 显示它同步到的 Agents;行上的计数按钮会打开它们的开关。**添加服务器** 接受 URL、命令、粘贴的片段或文件;**从目标导入** 会读取某个已安装 Agent 现有的配置。每个 server 的菜单都有 **查看各 Agent 会写入的配置**,会列出来源和每个 Agent 的文件,并显示你选中的那一个,包括尚未保存的编辑。冲突会提供 **从该 Agent 导入** 或 **使用来源覆盖**。server 对话框的 **工具** 区块用于设置[工具策略](./mcp.md#tool-policy):**加载工具**,它会用对话框当前的设置(无论是否已保存)启动 server 一次并列出工具供勾选;用于 `*` 通配符的 **排除规则** 行;该区块会列出每个未应用部分策略的所选 Agent,设置了策略时该行会显示一个标签。对于 Pi server,对话框还提供 [Pi 内置 MCP](./mcp.md#pi) 的设置:工具暴露方式和其他 Pi 设置,后者以 JSON 形式填写 [`piOptions`](./mcp.md#pi-options),说明位于信息提示中。**默认值** 用于编辑 `mcp.targets`。Sync 框中的 **Sync MCP** 会列出待写入的更改,并只写入 MCP 配置文件,同时为每个文件保留一份备份;其下方的 [**检查**](./mcp.md#check-servers-before-an-agent-starts-them) 用于检查 server,**备份与还原** 用于预览并恢复这些备份。 |
|
||||
| **Plugins** | 每个 plugin 一行,以及它的 Agents 开关。展开一行还会列出该来源支持的其他 Agents;勾选一个会预览安装效果。行菜单可以同步、更新、移除,或打开 **View files**,即 Skillshare 审阅过的本地副本的只读浏览器。参见 [Manage plugins across tools](/docs/how-to/daily-tasks/sharing-plugins) |
|
||||
|
||||
+1
-1
@@ -90,7 +90,7 @@ skillshare ui start --clear-cache
|
||||
| **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。收到相同變更的 targets 會合併成一張卡片,依資料夾列出 skills。**Discard all** 會在確認後,把還沒有任何 target 收到的 skills 移到垃圾桶。當某個 target 的 `include` 篩選條件沒有符合任何 skill 時,會顯示提示說明這個 target 收不到任何 skill,**Edit filter** 會開啟設定該篩選條件的地方;Git Sync 在 pull 之後也會顯示同樣的提示 |
|
||||
| **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)。**Sync both ways** 會 commit 本機變更、pull 並合併、sync targets,然後 push,如同 [`push --pull`](/docs/reference/commands/push#push-and-pull-together);遇到衝突時會在 push 前停止。當 remote 因為有較新的 commits 而拒絕 push 時,錯誤訊息會提供 **Pull**。當第一次 pull 無法與 remote 合併時,會提供強制 pull 以本機檔案取代 remote 分支 |
|
||||
| **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** 和 **Link folder**。config 裡有尚未安裝的項目時,**Updates** 分頁和安裝對話框會提供 **Install all**,效果同不帶參數的 [`install`](/docs/reference/commands/install)。執行檢查後,已從來源 repo 刪除的 skills 會列出並提供 **Prune** 與 **Prune all**,把它們移到垃圾桶。**Link folder** 與 [`link`](/docs/reference/commands/link) 一樣把資料夾連結進 skills source:填入路徑、選填的連結名稱,`follow_source_links` 關閉時另有一個開啟它的核取方塊;被拒絕的資料夾會顯示與指令相同的原因。連結的資料夾會以獨立群組列出,帶有連結圖示與它指向的資料夾;該列的圖示按鈕(hover 時連結圖示會變成取消連結圖示)會先確認,再像 [`unlink`](/docs/reference/commands/unlink) 一樣取消連結:資料夾本身不受影響,連結可從 **Trash** 分頁還原。連結資料夾裡的 skill 仍可單獨解除安裝,它會從該資料夾移到 trash;連結的資料夾沒有 **Update repo** 與 **Uninstall repo**。列表與卡片檢視可依 **Folder**(tracked repo、`frontend/react` 這類資料夾,或 **Root**)篩選,也能依 **Folder** 分組,Root 排最前,其餘資料夾依名稱 A→Z 排序。**tree** 檢視左邊顯示 source 資料夾,右邊顯示詳細資訊:點資料夾或 skill 來選取,Cmd/Ctrl 點擊加入選取,Shift 點擊選取範圍,雙擊 skill 開啟它。右邊可用一個開關啟用或停用所有選取的項目(被 `.skillignore.local` 的 `!` 規則保持啟用的項目會回報為失敗並附上原因)、設定它們的 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** 也會開啟同一個對話框。檔案瀏覽器會透過被跟隨的 source 連結列出 `SKILL.md` 與附件,包含連結本身就是 skill 根目錄的情況。 |
|
||||
| **Skills** / **Agents** | 已安裝的項目、**Updates** 分頁與 **Trash** 分頁。Skills 還有一個 **Analyze** 分頁,用來估算每個 skill 為 target 的 context 增加多少 tokens。**Install** 可搜尋 GitHub,或從 URL 或路徑安裝。選單裡也有開啟建立精靈的 **New skill** 和 **Link folder**。config 裡有尚未安裝的項目時,**Updates** 分頁和安裝對話框會提供 **Install all**,效果同不帶參數的 [`install`](/docs/reference/commands/install)。執行檢查後,已從來源 repo 刪除的 skills 會列出並提供 **Prune** 與 **Prune all**,把它們移到垃圾桶。**Link folder** 與 [`link`](/docs/reference/commands/link) 一樣把資料夾連結進 skills source:填入路徑、選填的連結名稱,`follow_source_links` 關閉時另有一個開啟它的核取方塊;被拒絕的資料夾會顯示與指令相同的原因。連結的資料夾會以獨立群組列出,帶有連結圖示與它指向的資料夾;該列的圖示按鈕(hover 時連結圖示會變成取消連結圖示)會先確認,再像 [`unlink`](/docs/reference/commands/unlink) 一樣取消連結:資料夾本身不受影響,連結可從 **Trash** 分頁還原。連結資料夾裡的 skill 仍可單獨解除安裝,它會從該資料夾移到 trash;連結的資料夾沒有 **Update repo** 與 **Uninstall repo**。列表與卡片檢視可依 **Folder**(tracked repo、`frontend/react` 這類資料夾,或 **Root**)篩選,也能依 **Folder** 分組,Root 排最前,其餘資料夾依名稱 A→Z 排序。列表檢視中,位在另一個 skill 資料夾裡的 skill 會列在那個 skill 底下;父列預設收合並顯示巢狀 skill 的數量,搜尋時全部展開,分頁只計算最上層的列。**tree** 檢視左邊顯示 source 資料夾,右邊顯示詳細資訊:點資料夾或 skill 來選取,Cmd/Ctrl 點擊加入選取,Shift 點擊選取範圍,雙擊 skill 開啟它。右邊可用一個開關啟用或停用所有選取的項目(被 `.skillignore.local` 的 `!` 規則保持啟用的項目會回報為失敗並附上原因)、設定它們的 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** 也會開啟同一個對話框。檔案瀏覽器會透過被跟隨的 source 連結列出 `SKILL.md` 與附件,包含連結本身就是 skill 根目錄的情況。 |
|
||||
| **Extras** | **目錄**:與 skills 一同同步的 rules、commands 及其他資料夾。**Edit target** 可修改 target 的資料夾、檔名、模式、flatten 設定與[檔案篩選](./extras.md#choosing-files),並即時預覽;**Edit extra** 可重新命名 extra,或改指向另一個來源資料夾。**AGENTS.md**:在 global mode 中是共用 `AGENTS.md` 與使用它們的 targets;在專案中則是專案的 `./AGENTS.md`,以及每個 target 是否讀得到它。詳見[讓多個工具共用一份 AGENTS.md](../../how-to/daily-tasks/sharing-instructions.md) **Memory**: [記憶共用教學](../../how-to/daily-tasks/sharing-memory.md)(英文截圖)。搜尋、預覽、編輯、刪除筆記、INDEX 連結、衝突時保留草稿、Backup Files 歷史與還原,以及 **Connect to agents** → **Review changes** → **Apply changes**;設定狀態不代表已讀取 |
|
||||
| **MCP** | 每個 server 一列,並以 chips 顯示它同步至哪些 Agents;列上的計數按鈕會開啟它們的切換開關。**新增伺服器** 接受 URL、指令、貼上的片段或檔案;**從目標匯入** 讀取已安裝 Agent 目前的設定。每個 server 的選單都有 **檢視各 Agent 會寫入的設定**,會列出來源與每個 Agent 的檔案,並顯示你選取的那一個(含尚未儲存的編輯內容)。衝突時提供 **從該 Agent 匯入** 或 **以來源覆寫**。server 對話框的 **工具** 區塊用來設定[工具政策](./mcp.md#tool-policy):**載入工具**,它會用對話框目前的設定(不論是否已儲存)啟動 server 一次並列出工具供勾選;用於 `*` 萬用字元的 **排除規則** 列;區塊會列出每個不套用部分政策的已選 Agent,設定政策後該列也會顯示標籤。對於 Pi server,對話框另有 [Pi 內建 MCP](./mcp.md#pi) 的設定:工具曝光模式與其他 Pi 設定,後者以 JSON 填入 [`piOptions`](./mcp.md#pi-options),說明則放在資訊提示中。**預設值** 用來編輯 `mcp.targets`。Sync 框中的 **Sync MCP** 會列出待寫入的變更,只寫入 MCP 設定檔,並為每個檔案保留備份;它下方的 [**檢查**](./mcp.md#check-servers-before-an-agent-starts-them) 會檢查 servers,**備份與還原** 則可預覽並還原這些備份。 |
|
||||
| **Plugins** | 每個 plugin 一列,並以其 Agents 作為切換開關。展開一列還會列出來源支援的其他 Agents;勾選其中之一即可預覽安裝內容。列選單可以同步、更新、移除,或開啟 **View files**,也就是唯讀瀏覽 Skillshare 已檢視過的本機副本。參見 [跨工具管理 plugins](/docs/how-to/daily-tasks/sharing-plugins) |
|
||||
|
||||
Reference in New Issue
Block a user