Ki_i dZddlZddlZddlZddlZddlZddlZddlmZddl m Z ddl m Z m Z mZejeZ ddlmZmZmZdZn #e$rdZYnwxYwd ed eefd ZddlZe Zed z Zd ZdZdZdZ ej!dZ"hdZ#d e$fdZ%ded eefdZ&deed eefdZ'ded eefdZ(dHdeded eefdZ)dIdeded efdZ*ded ee ee ffdZ+ded eefd Z,dJdeded"ed dfd#Z-dIdededed e ee ffd$Z.deded e ee ffd%Z/ dKded&ed'eded(e$d e ee ff d)Z0ded e ee ffd*Z1deded+ed e ee ffd,Z2deded e ee ffd-Z3 dLd.ededededed+ed&ed'ed(e$d efd/Z4d0d1d2d3gd4d5d6d3d7d8d3d9d8d3d:d8d3d;d8dd8d3d?d8d3d@d8dA d.dgdBdCZ5ddDl6m7Z7e7j8d0d e5dEdFGdS)Mu 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_home)DictAnyOptional) scan_skillshould_allow_installformat_scan_reportTF skill_dirreturnc^tsdS t|d}t|\}}|durt|}d|d|S|,t|}td|dSn5#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): z-Agent-created skill has security findings: %szSecurity scan failed for %s: %sTexc_info)_GUARD_AVAILABLErr r loggerwarning Exception)r resultallowedreasonreportes 5/home/ubuntu/hermes-agent/tools/skill_manager_tool.py_security_scan_skillr8s t WIo>>>.v66 e  '//FLLLFLL L ?'//F NNJF S S S4  WWW8)QQUVVVVVVVVW 4s=A8 ,A88 B*B%%B*skills@iiiz^[a-z0-9][a-z0-9._-]*$>assetsscripts templates referencescdS)zBSkill management has no external requirements -- always available.Tr#rcheck_skill_manage_requirementsr%_s 4r$namec|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_namer-hsn )(( 4yy?""B_BBBB   t $ $  R4 R R R  4r$categoryc|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*r+r,)r.s r_validate_categoryr5vst h $ $,++~~H t h$(** Z Z Z Z  8}}&&@?@@@@   x ( (  Z Z Z Z  4r$contentcj|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.).)r4 startswithresearchstartyaml safe_load YAMLErrorr2dictr)r3MAX_DESCRIPTION_LENGTHend)r6 end_match yaml_contentparsedrbodys r_validate_frontmatterrHs~ ==??*))   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)r6rJs r_validate_content_sizerNsY  7||--- - -#g,, > - -. 5 - - - 4r$c4|r t|z |z St|z S)zFBuild the directory path for a new skill, optionally under a category.) SKILLS_DIR)r&r.s r_resolve_skill_dirrQs%,H$t++  r$ctsdStdD]}|jj|kr d|jicSdS)zX Find a skill by name in ~/.hermes/skills/. Returns {"path": Path} or None. NrIpath)rPexistsrglobparentr&)r&skill_mds r _find_skillrXsg     t$$Z00-- ? 4 ' 'HO, , , , ( 4r$ file_pathc*|sdSt|}d|jvrdS|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. zfile_path is required.z..z%Path traversal ('..') is not allowed.rz, zFile must be under one of: z. Got: ''z5Provide a file path, not just a directory. Example: 'z /myfile.md'N)rpartsALLOWED_SUBDIRSjoinsortedr))rY normalizedrs r_validate_file_pathrbs (''iJ z66  Kz/2/II))F?3344JWJJiJJJJ : q  gzGWXYGZgggg 4r$utf-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.)dirprefixsuffixwrdNz6Failed to remove temporary file %s during atomic writer)rVmkdirtempfilemkstempr3r&osfdopenwritereplacerunlinkOSErrorrerror)rYr6rdfd 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.FsuccessryzA skill named 'z' already exists at rSriTrfrI) ignore_errorsSkill 'z ' created.)rmessagerSrWr.zTo add reference files, templates, or scripts, use skill_manage(action='write_file', name='{}', file_path='references/example.md', file_content='...')hint)r-r5rHrNrXrQrpr}rshutilrmtreer3 relative_torPformat) r&r6r.errexistingr rW scan_errorrs r _create_skillrs   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 Mr$ct|}|rd|dSt|}|rd|dSt|}|s dd|ddS|ddz }|r|dnd }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.rSrIrcroNTz ' updated.rrrS)rHrNrXrT read_textr}rr3)r&r6rrrWoriginal_contentrs r _edit_skillrPs6  ( (C 0 3///  ) )C 0 3///4  H t +rT+r+r+rsss*,H?G?P?PZx))7);;;VZx)))&hv&677J7  ' x)9 : : : :666-T---HV$%%  r$ old_string new_string replace_allc |sdddS|dddSt|}|s dd|ddS|d}|rt|}|rd|dS||z }n|d z }|sdd ||dS|d } d dlm} | | |||\} } } | 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.rSrIzFile not found: rcror)fuzzy_find_and_replaceiz...rj)rry file_previewrJz&Patch would break SKILL.md structure: TzPatched z in skill 'z' (z replacementsz).rr) rXrbrTrrtools.fuzzy_matchrr)rNrHr}r)r&rrrYrrr rtargetr6r new_content match_count match_errorpreview target_labelrrs r _patch_skillrqs R +PQQQ +|}}}4  H I +GT+G+G+GHHH I(!),,  4$s33 3Y&Z' ==??_ +]f>P>PQZ>[>[+]+]^^^00G 988888,B,BZ--)Kk $3$-CLL3,>,>55BG #   &/=::IL L A A AC 0 3/// #K00   G#GG  v{+++&i00J76#3444 :666Z HjjyZZUYZZ^iZZJMNNNwzwzTVZZZ  r$c6t|}|s dd|ddS|d}tj||j}|tkrI|r5t |s|dd|ddS) zDelete a skill.FrrrrSTz ' deleted.r) rXrrrVrPrTanyiterdirrmdir)r&rr rVs r _delete_skillrs4  H I +GT+G+G+GHHH I M) F  FNNAdd or overwrite a supporting file within any skill directory.Frrjzfile_content is required.rczFile content is rLz bytes (limit: z7 bytes / 1 MiB). Consider splitting into smaller files.rrz2' not found. Create it first with action='create'.rSTrfroN) missing_okFile 'z' written to skill ''.r)rbr)encodeMAX_SKILL_FILE_BYTESrNrXrVrprTrr}rrwr3) r&rYrr content_bytesrrrrs r _write_filers i ( (C 0 3/// HLB.. +FGGG ++G4455M+++:=;::/D:::    !Y ? ? ?C 0 3///4  H o +mT+m+m+mnnn f  )F Mt444=C]]__Vv'''999RVv|,,,&hv&677J7  ' v'7 8 8 8 8 MMTM * * * :666CICC4CCCF   r$c t|}|rd|dSt|}|s dd|ddS|d}||z }|sg}tD]|}||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.FrrrrS*rz' not found in skill 'rN)rryavailable_filesTz' removed from skill 'r)rbrXrTr^rUis_fileappendr3rrwrVrrr) r&rYrrr r availablesubdirdr|rVs r _remove_filer s i ( (C 0 3///4  H I +GT+G+G+GHHH I  "F ==??   % H HFF"Axxzz HHHAyy{{H!((Q]]9-E-E)F)FGGGGiGGtGGG,5?yy4    MMOOO]F v}}s6>>;K;K7L7L EIEETEEE  r$actionc J|dkr.|stjddddSt|||} n!|dkr,|stjddddSt||} n|dkrJ|stjdd ddS|tjdd ddSt |||||} n|d krt |} n|d krH|stjddddS|tjddddSt |||} n;|dkr,|stjddddSt||} n dd|dd} | dr$ ddl m } | dn#t$rYnwxYwtj| dS)zz Manage user-created skills. Dispatches to the appropriate action handler. Returns JSON string with results. createFzVcontent is required for 'create'. Provide the full SKILL.md text (frontmatter + body).r) ensure_asciieditzGcontent 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_filerr) clear_skills_system_prompt_cacheT)clear_snapshot) jsondumpsrrrrrrgetagent.prompt_builderrr) rr&r6r.rYrrrrrrs r skill_manager9s  i:%;STTchiii itWh77 6   Z:%;DEETYZZZ ZT7++ 7   P:%:yzzJOPPP P  :%;IJJY^___ _dJ I{SS 8  t$$ <   ]:%;GHHW\]]] ]  :%:fggv{||| |T9l;; =  {:%:deetyzzz zdI..#.E.E.E.EFF zz)  M M M M M M , ,D A A A A A    D  :f5 1 1 11s,E?? F  F ruManage skills (create, update, delete). Skills are your procedural memory — reusable approaches for recurring task types. New skills go to ~/.hermes/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.)typeenumr9zSkill name (lowercase, hyphens/underscores, max 64 chars). Must match an existing skill for patch/edit/delete/write_file/remove_file.)rr9zFull 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&r6rrrr.rYr)r propertiesrequired)r&r9 parameters)registryc t|dd|dd|d|d|d|d|d|d |d d  S) Nrrjr&r6r.rYrrrrF) rr&r6r.rYrrrr)rr)argskws rrs|xx"%% XXfb ! !##*%%((;''XXn--88L))88L))HH]E22 4 4 4r$u📝)r&toolsetschemahandleremoji)rI)N)rc)NF)NNNNNNF)9__doc__rloggingrsr;rrqpathlibrhermes_constantsrtypingrrr getLogger__name__rtools.skills_guardrr r r ImportErrorr3rr> HERMES_HOMErPr*rBrMrcompiler+r^boolr%r-r5rHrNrQrXrbr}rrrrrrrSKILL_MANAGE_SCHEMAtools.registryrregisterr#r$rrsBB  ,,,,,,&&&&&&&&&&  8 $ $WWWWWWWWWWDXc]( o 8 # !  455 CBB  #    #8C=2$3$8C=$$$$N  C  Xc]    SC4 c htCH~6    38C=4$RVH666c6S6DcN6666rcCDcNJ SS SSS S  S  #s(^ SSSSlS#X(/c/c//c3h////d%s%s%tCH~%%%%^:2:2 :2 :2:2 :2  :2  :2:2:2:2 :2:2:2:2D  Y&!ZZZ7 !a!U!)!2"{ !/!N!Qs= = |v&AAA+WWv$#####    4 4 s AAA