id;d?d@d;d6dAd;d6dBd;d6dCd;dD d0dgdEdFZ8ddGl9m:Z:m;Z;e:j<d2d e8dHdIJdS)Pu Skill Manager Tool -- Agent-Managed Skill Creation & Editing Allows the agent to create, update, and delete skills, turning successful approaches into reusable procedural knowledge. New skills are created in ~/.hermes/skills/. Existing skills (bundled, hub-installed, or user-created) can be modified or deleted wherever they live. Skills are the agent's procedural memory: they capture *how to do a specific type of task* based on proven experience. General memory (MEMORY.md, USER.md) is broad and declarative. Skills are narrow and actionable. Actions: create -- Create a new skill (SKILL.md + directory structure) edit -- Replace the SKILL.md content of a user skill (full rewrite) patch -- Targeted find-and-replace within SKILL.md or any supporting file delete -- Remove a user skill entirely write_file -- Add/overwrite a supporting file (reference, template, script, asset) remove_file-- Remove a supporting file from a user skill Directory layout for user skills: ~/.hermes/skills/ ├── my-skill/ │ ├── SKILL.md │ ├── references/ │ ├── templates/ │ ├── scripts/ │ └── assets/ └── category-name/ └── another-skill/ └── SKILL.md N)Path)get_hermes_homedisplay_hermes_home)DictAnyOptionalTuple) scan_skillshould_allow_installformat_scan_reportTF skill_dirreturncjtsdS t|d}t|\}}|durt|}d|d|S|2t|}td|d|d|Sn5#t $r(}td||d Yd}~nd}~wwxYwdS) zOScan a skill directory after write. Returns error string if blocked, else None.Nz agent-created)sourceFz"Security scan blocked this skill (z): z4Agent-created skill blocked (dangerous findings): %szSecurity scan failed for %s: %sTexc_info)_GUARD_AVAILABLEr r r loggerwarning Exception)r resultallowedreasonreportes @/home/agentuser/.hermes/hermes-agent/tools/skill_manager_tool.py_security_scan_skillr8s t WIo>>>.v66 e  '//FLLLFLL L ?(//F NNQSY Z Z ZLLLFLL L  WWW8)QQUVVVVVVVVW 4s=A> 3A>> B0B++B0skills@i skill_pathc |tdS#t$rYdSwxYw)zCheck if a skill path is within the local SKILLS_DIR. Skills found in external_dirs are read-only from the agent's perspective. TF)resolve relative_to SKILLS_DIR ValueError)r s r_is_local_skillr&WsZ ((););)=)=>>>t uus>A AAiiz^[a-z0-9][a-z0-9._-]*$>assetsscripts templates referencesnamec|sdSt|tkr dtdSt|sd|dSdS)z>Validate a skill name. Returns error message or None if valid.zSkill name is required.zSkill name exceeds characters.zInvalid skill name 'ze'. Use lowercase letters, numbers, hyphens, dots, and underscores. Must start with a letter or digit.N)lenMAX_NAME_LENGTH VALID_NAME_REmatch)r+s r_validate_namer2osn )(( 4yy?""B_BBBB   t $ $  R4 R R R  4categoryc|dSt|tsdS|}|sdSd|vsd|vrd|dSt|tkr dtdSt |sd|dSdS) zFValidate an optional category name used as a single directory segment.NzCategory must be a string./\zInvalid category 'zn'. Use lowercase letters, numbers, hyphens, dots, and underscores. Categories must be a single directory name.zCategory exceeds r-) isinstancestrstripr.r/r0r1)r4s r_validate_categoryr;}st h $ $,++~~H t h$(** Z Z Z Z  8}}&&@?@@@@   x ( (  Z Z Z Z  4r3contentcj|sdS|dsdStjd|dd}|sdS|d|dz} t j|}n!#t j$r}d|cYd}~Sd}~wwxYwt|tsd Sd |vrd Sd |vrd Stt|d tkr dtdS|| dzd}|sdSdS)z Validate that SKILL.md content has proper frontmatter with required fields. Returns error message or None if valid. zContent cannot be empty.z---zPSKILL.md must start with YAML frontmatter (---). See existing skills for format.z \n---\s*\nNzISKILL.md frontmatter is not closed. Ensure you have a closing '---' line.zYAML frontmatter parse error: z6Frontmatter must be a YAML mapping (key: value pairs).r+z&Frontmatter must include 'name' field. descriptionz-Frontmatter must include 'description' field.zDescription exceeds r-zRSKILL.md must have content after the frontmatter (instructions, procedures, etc.).)r: startswithresearchstartyaml safe_load YAMLErrorr8dictr.r9MAX_DESCRIPTION_LENGTHend)r< end_match yaml_contentparsedrbodys r_validate_frontmatterrNs~ ==??*))   e $ $baa -55I [ZZ1Y__..223L4 -- >4443333333334 fd # #HGG V77F"">> 3vm$ % %&&)???J&<JJJJ 9==??Q&'' ( . . 0 0D dcc 4s/BB"BB"B"SKILL.mdlabelctt|tkr|dt|ddtddSdS)zCheck that content doesn't exceed the character limit for agent writes. Returns an error message or None if within bounds. z content is ,z characters (limit: za). Consider splitting into a smaller SKILL.md with supporting files in references/ or templates/.N)r.MAX_SKILL_CONTENT_CHARS)r<rPs r_validate_content_sizerTsY  7||--- - -#g,, > - -. 5 - - - 4r3c4|r t|z |z St|z S)zFBuild the directory path for a new skill, optionally under a category.)r$)r+r4s r_resolve_skill_dirrVs%,H$t++  r3cddlm}|D]L}|s|dD]}|jj|kr d|jiccS MdS)z Find a skill by name across all skill directories. Searches the local skills dir (~/.hermes/skills/) first, then any external dirs configured via skills.external_dirs. Returns {"path": Path} or None. r)get_all_skills_dirsrOpathN)agent.skill_utilsrXexistsrglobparentr+)r+rX skills_dirskill_mds r _find_skillr`s655555))++11   ""  "((44 1 1H#t++000000, 1 4r3 file_pathc:ddlm}|sdSt|}||rdS|jr|jdtvr0dt t}d|d|dSt|jd krd |jdd Sd S) z Validate a file path for write_file/remove_file. Must be under an allowed subdirectory and not escape the skill dir. r)has_traversal_componentzfile_path is required.z%Path traversal ('..') is not allowed.z, zFile must be under one of: z. Got: ''z5Provide a file path, not just a directory. Example: 'z /myfile.md'N)tools.path_securityrcrpartsALLOWED_SUBDIRSjoinsortedr.)rarc normalizedrs r_validate_file_pathrls <;;;;; (''iJy))766  Kz/2/II))F?3344JWJJiJJJJ : q  gzGWXYGZgggg 4r3cDddlm}||z }|||}|rd|fS|dfS)zNResolve a supporting-file path and ensure it stays within the skill directory.r)validate_within_dirN)rfrn)r rarntargeterrors r_resolve_skill_targetrqsL777777  "F   2 2E U{ 4<r3utf-8encodingc|jddtjt |jd|jdd\}} t j|d|5}||d d d n #1swxYwYt j ||d S#t$rE t j |n-#t$r td |d YnwxYwwxYw) au Atomically write text content to a file. Uses a temporary file in the same directory and os.replace() to ensure the target file is never left in a partially-written state if the process crashes or is interrupted. Args: file_path: Target file path content: Content to write encoding: Text encoding (default: utf-8) Tparentsexist_ok.z.tmp.)dirprefixsuffixwrsNz6Failed to remove temporary file %s during atomic writer)r]mkdirtempfilemkstempr9r+osfdopenwritereplacerunlinkOSErrorrrp)rar<rsfd temp_pathfs r_atomic_write_textr sk4$777$   ! !(9>(((MB  Yr3 2 2 2 a GGG                   9i(((((  m Ii  m m m LLQS\gkL l l l l l m sTB.*B  B. BB.BB.. C=9C C='C85C=7C88C=ct|}|rd|dSt|}|rd|dSt|}|rd|dSt|}|rd|dSt |}|rdd|d|dddSt ||}|dd|d z }t||t|}|rtj |d d|dSdd |d t| tt|d }|r||d<d||d<|S)z.Create a new user skill with SKILL.md content.FsuccessrpzA skill named 'z' already exists at rYrxTrurO) ignore_errorsSkill 'z ' created.)rmessagerYr_r4zTo add reference files, templates, or scripts, use skill_manage(action='write_file', name='{}', file_path='references/example.md', file_content='...')hint)r2r;rNrTr`rVrrrshutilrmtreer9r#r$format) r+r<r4errexistingr r_ scan_errorrs r _create_skillr0s   C 0 3/// X & &C 0 3///  ( (C 0 3///  ) )C 0 3///4  H TtTT&AQTTT   #422I OOD4O000:%Hx)))&i00J7 it4444 :666-T---I))*5566MM F &%z nntntuynznz 6N Mr3ct|}|rd|dSt|}|rd|dSt|}|s dd|ddSt|ds dd|ddS|ddz }|r|d nd }t ||t|d}|r|t ||d|dSd d|d t|dd S)z:Replace the SKILL.md of any existing skill (full rewrite).Frrz7' not found. Use skills_list() to see available skills.rYc' is in an external directory and cannot be modified. Copy it to your local skills directory first.rOrrr~NTz ' updated.rrrY) rNrTr`r&r[ read_textrrr9)r+r<rrr_original_contentrs r _edit_skillris{  ( (C 0 3///  ) )C 0 3///4  H t +rT+r+r+rsss 8F+ , ,` ,_T,_,_,_`` `*,H?G?P?PZx))7);;;VZx)))&hv&677J7  ' x)9 : : : :666-T---HV$%%  r3 old_string new_string replace_allc <|sdddS|dddSt|}|s dd|ddSt|ds dd|d dS|d}|r1t|}|rd|dSt||\}}|rd|dSn|d z }|sdd ||dS|d } ddlm} | | |||\} } } }|r(| ddt| dkrdndz}d||dS|sd n|}t| |}|rd|dS|st| }|rdd|dS| }t|| t|}|rt||d|dSdd|sd n|d|d| d| dkrdndd dS)zTargeted find-and-replace within a skill file. Defaults to SKILL.md. Use file_path to patch a supporting file instead. Requires a unique match unless replace_all is True. Fz#old_string is required for 'patch'.rNzOnew_string is required for 'patch'. Use an empty string to delete matched text.r ' not found.rYrrOzFile not found: rrr~r)fuzzy_find_and_replaceiz...ry)rrp file_previewrPz&Patch would break SKILL.md structure: TzPatched z in skill 'z' (z replacementsz).rr)r`r&rlrqr[r#rtools.fuzzy_matchrr.rTrNrr)r+rrrarrr rror<r new_content match_count _strategy match_errorpreview target_labelrrs r _patch_skillrs. R +PQQQ +|}}}4  H I +GT+G+G+GHHH 8F+ , ,` ,_T,_,_,_`` ` I (!),,  4$s33 3+IyAA   4$s33 3 4Z' ==??_ +]f>P>PQZ>[>[+]+]^^^00G 9888887M7MZ884Ki $3$-CLL3,>,>55BG #   &/=::IL L A A AC 0 3/// #K00   G#GG  v{+++&i00J76#3444 :666Z HjjyZZUYZZ^iZZJMNNNwzwzTVZZZ  r3crt|}|s dd|ddSt|ds dd|ddS|d}tj||j}|t krI|r5t|s| dd|dd S) zDelete a skill.FrrrrYz4' is in an external directory and cannot be deleted.Tz ' deleted.r) r`r&rrr]r$r[anyiterdirrmdir)r+rr r]s r _delete_skillrs4  H I +GT+G+G+GHHH 8F+ , ,q +oT+o+o+oppp I M) F  FNNAdd or overwrite a supporting file within any skill directory.Frryzfile_content is required.rrzFile content is rRz bytes (limit: z7 bytes / 1 MiB). Consider splitting into smaller files.rrz2' not found. Create it first with action='create'.rYrTrur~N) missing_okFile 'z' written to skill ''.r)rlr.encodeMAX_SKILL_FILE_BYTESrTr`r&rqr]rr[rrrrr9) r+rarr content_bytesrrorrs r _write_filersX i ( (C 0 3/// HLB.. +FGGG ++G4455M+++:=;::/D:::    !Y ? ? ?C 0 3///4  H o +mT+m+m+mnnn 8F+ , ,` ,_T,_,_,_`` `'(8)DDKFC 0 3/// Mt444=C]]__Vv'''999RVv|,,,&hv&677J7  ' v'7 8 8 8 8 MMTM * * * :666CICC4CCCF   r3c $t|}|rd|dSt|}|s dd|ddSt|ds dd|ddS|d}t||\}}|rd|dS|sg}t D]|}||z }|ra|dD]K} | r5|t| |L}dd|d |d |r|nd d S| |j } | |krI| r5t| s| d d|d|d dS)z2Remove a supporting file from any skill directory.FrrrrYz5' is in an external directory and cannot be modified.*rz' not found in skill 'rN)rrpavailable_filesTz' removed from skill 'r)rlr`r&rqr[rhr\is_fileappendr9r#rr]rrr) r+rarrr ro availablesubdirdrr]s r _remove_filer6s i ( (C 0 3///4  H I +GT+G+G+GHHH 8F+ , ,r +pT+p+p+pqqq I' 9==KFC 0 3/// ==??   % H HFF"Axxzz HHHAyy{{H!((Q]]9-E-E)F)FGGGGiGGtGGG,5?yy4    MMOOO]F v}}s6>>;K;K7L7L EIEETEEE  r3actionc |dkr%|stddSt|||} n|dkr$|stddSt||} n|dkr:|stddS|td dSt|||||} n|d krt |} nq|d kr8|std dS|tddSt |||} n3|dkr$|stddSt ||} n dd|dd} | dr$ ddlm } | dn#t$rYnwxYwtj | dS)zz Manage user-created skills. Dispatches to the appropriate action handler. Returns JSON string with results. createzVcontent is required for 'create'. Provide the full SKILL.md text (frontmatter + body).F)reditzGcontent is required for 'edit'. Provide the full updated SKILL.md text.patchz=old_string is required for 'patch'. Provide the text to find.NzLnew_string is required for 'patch'. Use empty string to delete matched text.delete write_filezJfile_path is required for 'write_file'. Example: 'references/api-guide.md'z*file_content is required for 'write_file'. remove_filez(file_path is required for 'remove_file'.zUnknown action 'z<'. Use: create, edit, patch, delete, write_file, remove_filerrr) clear_skills_system_prompt_cacheT)clear_snapshot) ensure_ascii) tool_errorrrrrrrgetagent.prompt_builderrrjsondumps) rr+r<r4rarrrrrrs r skill_managerhs6  GvAFGGG GtWh77 6   xgqvwww wT7++ 7   n]glmmm m  lv{||| |dJ I{SS 8  t$$ <   {jtyzzz z  JTYZZZ ZT9l;; =  YHRWXXX XdI..#.E.E.E.EFF zz)  M M M M M M , ,D A A A A A    D  :f5 1 1 11s3E EEruManage skills (create, update, delete). Skills are your procedural memory — reusable approaches for recurring task types. New skills go to u{/skills/; existing skills can be modified wherever they live. Actions: create (full SKILL.md + optional category), patch (old_string/new_string — preferred for fixes), edit (full SKILL.md rewrite — major overhauls only), delete, write_file, remove_file. Create when: complex task succeeded (5+ calls), errors overcome, user-corrected approach worked, non-trivial workflow discovered, or user asks you to remember a procedure. Update when: instructions stale/wrong, OS-specific failures, missing steps or pitfalls found during use. If you used a skill and hit issues not covered by it, patch it immediately. After difficult/iterative tasks, offer to save as a skill. Skip for simple one-offs. Confirm with user before creating/deleting. Good skills: trigger conditions, numbered steps with exact commands, pitfalls section, verification steps. Use skill_view() to see format examples.objectstring)rrrrrrzThe action to perform.)typeenumr?zSkill name (lowercase, hyphens/underscores, max 64 chars). Must match an existing skill for patch/edit/delete/write_file/remove_file.)rr?zFull SKILL.md content (YAML frontmatter + markdown body). Required for 'create' and 'edit'. For 'edit', read the skill first with skill_view() and provide the complete updated text.zText to find in the file (required for 'patch'). Must be unique unless replace_all=true. Include enough surrounding context to ensure uniqueness.zXReplacement text (required for 'patch'). Can be empty string to delete the matched text.booleanzZFor 'patch': replace all occurrences instead of requiring a unique match (default: false).zOptional category/domain for organizing the skill (e.g., 'devops', 'data-science', 'mlops'). Creates a subdirectory grouping. Only used with 'create'.zPath to a supporting file within the skill directory. For 'write_file'/'remove_file': required, must be under references/, templates/, scripts/, or assets/. For 'patch': optional, defaults to SKILL.md if omitted.z0Content for the file. Required for 'write_file'.) rr+r<rrrr4rar)r propertiesrequired)r+r? parameters)registryrc t|dd|dd|d|d|d|d|d|d |d d  S) Nrryr+r<r4rarrrrF) rr+r<r4rarrrr)rr)argskws rr s|xx"%% XXfb ! !##*%%((;''XXn--88L))88L))HH]E22 4 4 4r3u📝)r+toolsetschemahandleremoji)rO)N)rr)NF)NNNNNNF)=__doc__rloggingrrArrpathlibrhermes_constantsrrtypingrrrr getLogger__name__rtools.skills_guardr r r r ImportErrorr9rrD HERMES_HOMEr$r/rHboolr&rSrcompiler0rhr2r;rNrTrVr`rlrqrrrrrrrrSKILL_MANAGE_SCHEMAtools.registryrrregisterr3rrsB  AAAAAAAA------------  8 $ $WWWWWWWWWWDXc]( o 8 #       "  455 CBB  #    #8C=2$3$8C=$$$$N  C  Xc]    SC4chtCH~6$38C=8TceHTNT\]`TaDa>b$RVH666c6S6DcN6666r!c!C!DcN!!!!P XX XXX X  X  #s(^ XXXXvS#X.4c4c44c3h4444n+s+s+tCH~++++j:2:2 :2 :2:2 :2  :2  :2:2:2:2 :2:2:2:2D  Y//11 Y Y Y&!ZZZ7 !a!U!)!2"{ !/!N!Qs= = |v&AAA+WWv0///////    4 4 s AAA