+ Q(iRt^RIHt^RIt^RIt^RIHt^RIHt^RI H t ^RI t ] 'd^RI Ht]!RR44t]!R R 44t]!R R 44tR RltRRltRR/RRlltRR/RRlltR#)zIClient utilities for discovering and downloading skills from MCP servers.) annotationsN) dataclass)Path) TYPE_CHECKING)Clientc:]tRt^t$RtR]R&R]R&R]R&RtR#) SkillSummaryz8Summary information about a skill available on a server.strname descriptionuriN__name__ __module__ __qualname____firstlineno____doc____annotations____static_attributes__r ^/Users/agent/.openclaw/workspace/venv/lib/python3.14/site-packages/fastmcp/utilities/skills.pyrrsB I Hrrc:]tRt^t$RtR]R&R]R&R]R&RtR#) SkillFilez(Information about a file within a skill.r pathintsizehashr Nrr rrrrs2 I I Irrc0]tRt^#t$RtR]R&R]R&RtR#) SkillManifestz-Full manifest of a skill including all files.r r zlist[SkillFile]filesr Nrr rrrr#s7 I rrc V^8dQhRRRR/#)clientrreturnzlist[SkillSummary]r )formats"r __annotate__r&+s))f));)rc "VP4GRjxL p.pVFp\VP4pVPR4'gK1VP R4'gKJV\ R4RpVP R^4^,pTP\TVP;'gRVR74K V#L5i)a8List all available skills from an MCP server. Discovers skills by finding resources with URIs matching the `skill://{name}/SKILL.md` pattern. Args: client: Connected FastMCP client Returns: List of SkillSummary objects with name, description, and URI Example: ```python from fastmcp import Client from fastmcp.utilities.skills import list_skills async with Client("http://skills-server/mcp") as client: skills = await list_skills(client) for skill in skills: print(f"{skill.name}: {skill.description}") ``` Nskill://z /SKILL.md/)r r r ) list_resourcesr r startswithendswithlenrsplitappendrr )r# resourcesskillsresourcer path_partr s& r list_skillsr5+s.++--I F(,, >>* % %#,,{*C*CC O-.I##C+A.D MM ( 4 4 : :  M%.s"C C4C C )A C 4C c$V^8dQhRRRRRR/#)r"r#r skill_namer r$rr )r%s"rr&r&Ws&%T%TV%T%T%Trc "RV R2pVPV4GRjxL pV'g\RV 24hV^,p\V\PP 4'd#\ P!VP4pM\RV 24h\VR,VR,Uu.uF&p\VR ,VR ,VR ,R 7NK( upR 7#L \ Pdp\RT 24ThRp?ii;iuupi \\3dp\RT 24ThRp?ii;i5i)zGet the manifest for a specific skill. Args: client: Connected FastMCP client skill_name: Name of the skill Returns: SkillManifest with file listing Raises: ValueError: If manifest cannot be read or parsed r(z /_manifestNz#Could not read manifest for skill: z!Invalid manifest JSON for skill: z&Unexpected manifest format for skill: skillr rrr)rrr)r r z#Invalid manifest format for skill: ) read_resource ValueError isinstancemcptypesTextResourceContentsjsonloadstextJSONDecodeErrorrrKeyError TypeError)r#r7 manifest_uriresultcontent manifest_dataefs&& rget_skill_manifestrLWsDj\4L'' 5 5F >zlKLLQiG'39999:: V JJw||4MA*NOO Tw''w//AqyqyqyI/  6## V@ MNTU U V i T>zlKLRSSTsoEC( EAE, C* ED4,D D'E*D?DDEDE,D;;EE overwriteFc ,V^8dQhRRRRRRRRR R /#) r"r#rr7r target_dir str | PathrMboolr$rr )r%s"rr&r&sATT TTT  T  Trc "\V4P4P4pW!, pVP4'dV'g\ RV R24h\ W4GRjxL pVP RRR7VPEFgp\VP4P4'dK/WFP, P4pVPV4'gKhRV RVP 2pVPV4GRjxL p V 'gKV ^,p VPP RRR7\V \PP 4'dVP#V P$4EK \V \PP&4'd3VP)\*P,!V P.44EKgEKj V#ELL5i)aDownload a skill and all its files to a local directory. Creates a subdirectory named after the skill containing all files. Args: client: Connected FastMCP client skill_name: Name of the skill to download target_dir: Directory where skill folder will be created overwrite: If True, overwrite existing skill directory. If False (default), raise FileExistsError if directory exists. Returns: Path to the downloaded skill directory Raises: ValueError: If skill cannot be found or downloaded FileExistsError: If skill directory exists and overwrite=False Example: ```python from fastmcp import Client from fastmcp.utilities.skills import download_skill async with Client("http://skills-server/mcp") as client: skill_path = await download_skill( client, "pdf-processing", "~/.claude/skills" ) print(f"Downloaded to: {skill_path}") ``` z Skill directory already exists: z . Use overwrite=True to replace.NT)parentsexist_okr(r))r expanduserresolveexistsFileExistsErrorrLmkdirr r is_absoluteis_relative_tor:parentr<r=r>r? write_textrBBlobResourceContents write_bytesbase64 b64decodeblob) r#r7rOrM skill_dirmanifest file_info file_pathfile_urirGrHs &&&$ rdownload_skillrhsNj!,,.668J'I).yk:- -  (;;HOOD4O0^^    + + - - /88: '' 22 j\9>>*:;++H55 ) td; gsyy== > >   . !?!? @ @  ! !&"2"27<<"@ A 5$8 E<6s2A HH-G?.B1HH H,CHHc(V^8dQhRRRRRRRR/#) r"r#rrOrPrMrQr$z list[Path]r )r%s"rr&r&s0'' '' '  'rc"\V4GRjxL p.pVF4p\WPWR7GRjxL pVPV4K6 V#LBL \dKLi;i5i)a%Download all available skills from a server. Args: client: Connected FastMCP client target_dir: Directory where skill folders will be created overwrite: If True, overwrite existing files Returns: List of paths to downloaded skill directories Example: ```python from fastmcp import Client from fastmcp.utilities.skills import sync_skills async with Client("http://skills-server/mcp") as client: paths = await sync_skills(client, "~/.claude/skills") print(f"Downloaded {len(paths)} skills") ``` N)rM)r5rhr r0rX)r#rOrMr2 downloadedr9rs&&$ r sync_skillsrlsu4v& &FJ ' JD   d #  '    sBA*A A*AAAA*A A'#A*&A''A*)r __future__rr`r@ dataclassesrpathlibrtypingr mcp.typesr=fastmcp.clientrrrrr5rLrhrlr rrrssO" ! %         )X%TPT  Tn' ''r