+ lHjaRt~0tRt^RIt^RIt^RIt^RIHtHt^RI t ^RI t ^RI t ^RI H t ^RIHtHtHtHtHt^RIt^RIHt^RIHtHt^RIHt^RIHtHtH t!H"t"^R I#H$t$H%t%H&t&H't'H(t(H)t)H*t*H+t+H,t,H-t.^R I/H0t0H1t1H2t2H3t3H4t4^R I5H6t6H7t7H8t8] Pr!]:4t;R R lt]>R, t?]?t@RRltARRltBRRltCRtD^@tERtFRtGRtH] P!R4tJ0RmtK] P!R4tLRtMRRltNR R!ltOR"R#ltPR$R%/R&R'lltQRR(R)lltRR*R+ltSRR,R-lltTR.R/ltUR0R1ltVR2R3ltWR4R5ltXRR6R7lltYR8R9ltZR:R;lt[RR<R=llt\R>R?lt]R@RAlt^RRBRCllt_RDRElt`RRFRGlltaRHRIltbRRJRKlltcRRLRMlltdRNROlteRPRQltfRRRSltg]P!RTR%RU7ti]^kRVtjRWtkRtlR`RaltmRbRcltnRdtoReRfRgRhRi]oRjRkRlRmRnRo/tpRpRqltqRRrRslltrRtRultsRvRw/ttRvRwRxRy/tuRvRwRxRz/tvRvRwRxR{/twR|R}ltxR~RRx]s!4RRvRRR_RvRRxRRR]x!ReRXRvRwRxR/RYRvRwRxR//R4]x!RiR\]uR]]vRRvRRxR/RZRvRwRxR//R4]x!RiRXRvRwRxR//R4]x!RlRZ]wR[RvRwRxR//R4]x!RnRZRvRwRxR//R4]x!RjR^RvRwRxR//R4.///RR_.//ty^RIzH{t{H|t|]{P!RR]yRRR7R#)uSkill Manager Tool — agent-managed skill creation & editing. Skills are the agent's procedural memory (narrow "how to do X"; MEMORY.md/USER.md are broad, declarative). New skills land in ~/.hermes/skills/ (or ``skills.create_dir``); existing skills (bundled, hub, user) are modified in place. Layout: ``/[category/]/SKILL.md`` + optional ``references/ templates/ scripts/ assets/``. N) ExitStacksuppressPath)AnyDictListOptionalTuple)get_hermes_home)atomic_write_textis_truthy_value)cfg_get)extract_skill_description)is_skill_description_truncated_for_promptparse_frontmatterSKILL_PROMPT_DESC_LIMIT) _background_review_delete_guard_background_review_preflight*_background_review_read_before_write_guard_containing_skills_root#_curator_consolidation_delete_guard_is_path_redirect _pinned_guard_validate_delete_target_is_background_review_refusal)_PATCH_EITHER_OR_PATCH_NEEDS_NEW_STRING_PATCH_NEEDS_OLD_STRING_op_shape_error_skill_manage_batch) scan_skillshould_allow_installformat_scan_reportc$V^8dQhR\/#return)bool)formats"=/home/ubuntu/.hermes/hermes-agent/tools/skill_manager_tool.py __annotate__r,)sdcn^RIHp\\V!4RR4RR7# \dR#i;i)u]skills.guard_agent_created (default False): opt-in — terminal() runs the same code ungated. load_configskillsguard_agent_createdFdefault)hermes_cli.configr0r r Exceptionr/s r+_guard_agent_created_enabledr7)s61w{}h@UV`eff s "% 44cFV^8dQhR\R\\,/#)r' skill_dirr(rr str)r*s"r+r,r,2sDXc]r-c&\4'gR#\VRR7p\V4wr#Vf\P RV4VRJdRV R\ V4 2#R# \ d$p\P RYRR 7Rp?R#Rp?ii;i) zPost-write scan (opt-in); error string if blocked, else None. An "ask" verdict (dangerous findings) is surfaced as an error so the agent can retry without them.Nz agent-created)sourcez4Agent-created skill blocked (dangerous findings): %sTz"Security scan blocked this skill (z): zSecurity scan failed for %s: %sexc_info)r7r"r#loggerwarningr$r6)r9resultallowedreasones& r+_security_scan_skillrF2s ( ) )WIo>.v6 ? NNQSY Z $ 7xtDVW]D^C_` `   W8)QUVV WsA A"" B-B  Br1c$V^8dQhR\/#r&r)r*s"r+r,r,Is__T_r-c\\\4pV\8wdV#\4R, #)awActive profile's skills dir at call time (multi-profile runtimes rebind per session). An explicitly patched module-level ``SKILLS_DIR`` (tests) wins over the live HERMES_HOME. Long-lived multi-profile runtimes (Dashboard/TUI/Desktop backend, cron, kanban workers) import this module once under the launch HERMES_HOME and later bind a different profile per session (#40677). r1)r SKILLS_DIR_SKILLS_DIR_AT_IMPORTr ) configureds r+ _skills_dirrLIs*j!J#'<<:^/BSV^B^^r-c0V^8dQhR\R\/#r'namer(r;r)r*s"r+r,r,Ts773747r-c\P!\V4PP RR44P 4p\ 4R, V R2, #)a]Per-skill lock file under ``/.locks/`` (same idiom as the usage ledger's ``.usage.json.lock``), never inside the skill dir so delete/recreate cannot unlink it under a waiting writer. Keyed by a digest of the basename so ``foo`` and ``category/foo`` share one lock and no name can hit a filesystem limit (callers validate the basename first).utf-8 surrogatepassz.locksz.lock)hashlibsha256rrOencode hexdigestrL)rOdigests& r+_skill_lock_pathrYTsI ^^DJOO227OL M W W YF =8 #&6 66r-c$V^8dQhR\/#)r'rOr;)r*s"r+r,r,]s33s3r-c0^RIHpV!\V44#)zRExclusive lock held across one skill's whole read-modify-write; thread-re-entrant.skill_file_lock)tools.skill_usager^rY)rOr^s& r+_skill_mutation_lockr`]s1 +D1 22r-c^RIHp\4p\VUu0uFp\ V4kK up4FpVP V!V44K V#uupi)z`Every lock of an atomic batch, acquired in one stable path order (deadlock-free across batches).r])r_r^rsortedrY enter_context)namesr^stackn lock_paths& r+_skill_mutation_locksrhcsO1 KE%@%Q-a0%@A  OI67B LAsAiiiz^[a-z0-9][a-z0-9._-]*$z \n---\s*\nz?Use lowercase letters, numbers, hyphens, dots, and underscores.c ^V^8dQhR\R\R\R\\,/#)r'valuelabelinvalidr(r;r )r*s"r+r,r,xs,;;S;;s;x};r-c\V4\8d V R\ R2#\PV4'dR#T#)z exceeds characters.N)lenMAX_NAME_LENGTH VALID_NAME_REmatch)rjrkrls&&&r+_check_identifierrtxs= 5zO# /!2,?? &&u--4:7:r-cFV^8dQhR\R\\,/#rNrm)r*s"r+r,r,~s"mmm#mr-c FV'gR#\VRRV R\ R24#)zSkill name is required.z Skill namezInvalid skill name ''. z# Must start with a letter or digit.)rt _NAME_RULErOs&r+_validate_namerz~s/ (  l24&JN>N h $ $+~~H#H:S ===G h$(* Xz7 ;;r- new_skillFcRV^8dQhR\R\R\\,/#)r'contentrr()r;r)r )r*s"r+r,r,s&!!3!d!xPS}!r-ctVP4'gR#VPR4pVPR4'gR#\P VR,4pV'gR#\ P !V^VP4^,4p\T\4'gR #RFpYS9gK R T R 2u# \TR ,4p\T4\8d R \ R2#T'dd\TP4PR44\8d3R\TP44 R\ R\^, R2#YP4^,RP4'gR#R# \ PdpRT 2uRp?#Rp?ii;i)aValidate frontmatter (name + description) and a non-empty body. ``new_skill`` (create only) also enforces SKILL_PROMPT_DESC_LIMIT so new skills never lose routing signal to index truncation; edit/patch skip it so existing over-limit skills stay maintainable.zContent cannot be empty.uz---zPSKILL.md must start with YAML frontmatter (---). See existing skills for format.NNzISKILL.md frontmatter is not closed. Ensure you have a closing '---' line.zYAML frontmatter parse error: Nz6Frontmatter must be a YAML mapping (key: value pairs). descriptionzFrontmatter must include 'z' field.zDescription exceeds roz'"zDescription is u# chars — new skills must fit the z-char system-prompt budget (one sentence, trigger first, ends with a period). The skill index truncates longer descriptions to zO chars + '...', destroying the routing signal. Move detail into the skill body.zRSKILL.md must have content after the frontmatter (instructions, procedures, etc.).)rOr)rlstrip startswith_FRONTMATTER_END_REsearchyaml safe_loadstart YAMLErrorrdictr;rpMAX_DESCRIPTION_LENGTHrend)rr end_matchparsedrEfielddescs&$ r+_validate_frontmatterrs| ==??)nnX&G   e $ $a#**72;7I Z4)//*;a*? @A fd # #G(  /wh? ?) vm$ %D 4y))%&<%=\JJS++E236MMc$**,/00S&'(U&*+,/ 0 1 ==?Q&' ( . . 0 0c ' >>4/s334s*.FF7(F2,F72F7cRV^8dQhR\R\R\\,/#)r'rrkr(rm)r*s"r+r,r,s%CXc]r-cb\V4\8dV R\V4R R\R R2#R#)z content is ,z characters (limit: za). Consider splitting into a smaller SKILL.md with supporting files in references/ or templates/.N)rpMAX_SKILL_CONTENT_CHARS)rrks&&r+_validate_content_sizersB 7|--g\#g,q!11EF]^_E`a   r-c0V^8dQhR\R\/#)r'rr(r[)r*s"r+r,r,s##r-c h\\4;_uu_4\PVR,4pV'dY\ \ P !V^VP4^,4PRR44R,uuRRR4#RRR4R# +'giR#;i)zBFirst 120 chars of the frontmatter description; '' on any failure.rr:NxNN) rr6rrr;rrrget)rfm_ends& r+_description_previewrs~ )  $++GBK8 t~~ga 0B&CDHHXZ[\]ab        s A2B  B1 cJV^8dQhR\R\R,R\/#)r'rOr|Nr(rP)r*s"r+r,r,s%**S*C$J*$*r-c\4p^RIHpV!4;'gTpY!;'gR, V, # \d\P RRR7L=i;i)zFNew-skill dir; honors ``skills.create_dir`` (e.g. a shared fleet dir).)get_skill_create_dirzskills.create_dir lookup failedTr>r)rLagent.skill_utilsrr6r@debug)rOr|basers&& r+_resolve_skill_dirrs\ =DG:#%-- >>r "T )) G 6 FGs<<"A! A!c$V^8dQhR\/#)r'rootr)r*s"r+r,r,s""4"r-c#"^RIHpVPR4F!pV!V4'dKVPxK# R#5i))is_excluded_skill_pathSKILL.mdN)rrrglobparent)rrskill_mds& r+_iter_skill_dirsrs08JJz*%h//// !+s &AAcFV^8dQhR\R\\,/#)r'rr(r:)r*s"r+r,r,sThsmr-c^RIHpVPRRR7R,pV!V4wr4TP R 4p\T\4'd TR \#R # \d\P RTRR7R #i;i) ueRead a SKILL.md's frontmatter ``name:`` — the name skills_list displays. Fail-quiet on unreadable files: the fallback lookup in ``_find_skill`` must never break the directory-name match, and an unreadable SKILL.md simply has no second name to offer. The value is truncated with the same ``MAX_NAME_LENGTH`` budget skills_list applies when displaying it. )r utf-8-sigreplace)encodingerrors:NiNzfrontmatter read failed for %sTr>NrO) rr read_textOSErrorr@rrrr;rq)rrr frontmatter_rOs& r+_read_frontmatter_namers7$$k)$LUS*73  ??6 "D$$_%%   5x$ Os*A#BBchV^8dQhR\R\\\\3,,/#rNr;r rr)r*s"r+r,r,s'55c5htCH~65r-c ^RIHpRpRV9gRV9d\4P4p.p\4pV!4EFpVP4'gK\V4FpVPV8Xd RV/uu#VeTVP4pVPV4'd-VPV4P4V8Xd RV/uu#\VR , 4V8XgKVR , p\\ 4;_uu_4VP4pRRR4W9gKVP#V4VP%V4K EK \'V4^8Xd RV^,/#V'd8\ P)R V\'V4R P+R V444R# \d&\ P RRR7\4pELi;i +'giL;i) u,Find a skill (local skills dir, then skills.external_dirs) -> ``{"path": Path}`` | None. Accepts the bare dir name (``axolotl``; matches category-nested skills too) and the categorized relative path (``mlops/axolotl``) — the two forms skill_view resolves. The categorized form matches RELATIVE to the local root only (relative_to raises for external dirs). As a last resort the frontmatter ``name:`` is matched too, so the name ``skills list`` and the dashboard display (frontmatter name wins over the directory name there) resolves everywhere instead of failing with a misleading "not found in active profile" error when the two names diverge. Directory-name matches keep priority — a frontmatter match is only considered after the whole scan found no directory/categorized match, so one skill's frontmatter cannot shadow another skill's directory. A display name held by two or more distinct skills resolves to nothing: like skill_view's same-tier collision refusal, refusing to guess beats silently mutating the wrong skill; the directory name still resolves.)get_all_skills_dirsNr~rzOskills dir resolve failed; categorized lookups fall back to the unresolved pathTr>pathruySkill display name '%s' is ambiguous (%d skills claim it: %s) — refusing to guess; resolve it by directory name insteadz; c38"TFp\V4xK R#5iNr[).0ps& r+ _find_skill..$s1R/Q#a&&/s)rrrLresolverr@rsetexistsrrOis_relative_to relative_toas_posixrrr6addappendrprAjoin) rOr local_rootdisplay_matches seen_display skills_dirr9resolvedkeys & r+ _find_skillrs 6J d{ddl '$..0J #%OL)+   "" )*5I~~% **%$,,.++J77$00<EEG4O"I..%i*&<=E*,i((++-C)* $$S)#**956,$ ?q *++ 3 #o& 1R/1R(R T A ' LLa  %J  '()(sF>G1 >,G.-G.1 H chV^8dQhR\R\\\\3,,/#rN)r;listtupler)r*s"r+r,r,(s(###U395E0F#r-c ra.p^RIHpV!4p\4pTP 4'dTP 4MTp.p\ \\4;_uu_4TR, P 4T8wdTPRTR, 34RRR4TR, P4'd\ \4;_uu_4TR, P4F_pTP4'gKTR, P 4T8XdK:TPTPTR, 34Ka RRR4TFrwrT P4'gK\ \4;_uu_4\T3Rl\T 44R4p T eTPY34RRR4Kt T# \dTu#i;i +'giELU;i \\3dEK!i;i +'giL;i +'giK;i)z``(profile, skill_dir)`` pairs for OTHER profiles holding ``name`` (so the not-found error can explain a wrong-profile mistake). Fail-quiet.)get_default_hermes_rootr1r4Nprofilesc3L<"TFqPS8XgKVxK R#5irry)rdrOs& r+r0_find_skill_in_other_profiles..HsR#?a66T>#?s$ $)hermes_constantsrr6rLrrrr RuntimeErrorris_diriterdirrOnextr) rOmatchesrr_active active_dir candidatesentry profile_namerhits f r+_find_skill_in_other_profilesr(s')G<&(mG&-nn&6&6"GJ*,J '< ( ( 8O $ $ &* 4   y$/: ; ) z!!## g  +446||~~(113zA B!!5::ux/?"@A7%/   ""  g  R#3J#?RTXYC 23 %/ N9  ) ( ( .   sY G"7G%3H G9%+H6H% G"!G"% G6 9H HH H H" % H6 c<V^8dQhR\R\R\/#)r'rOsuffixr(r[)r*s"r+r,r,Ns!c3r-c8^RIHpRV RV!4 R2p\V4p\V4^8Xd'V^,wrVVRV RV RV R2, pW1,#V'd.R P R V44pVR V R 2, pW1,#VR , pW1,#)zKNot-found error naming other profiles that hold the skill, plus ``suffix``.)_resolve_active_profile_nameSkill 'z' not found in active profile ''.z) A skill by that name exists in profile '' (z+). To edit it, switch profiles (`hermes -p z5`) or edit the file directly (file tools / terminal)., c32"TF wrRV R2xK R#5i)'N)rrrs& r+r)_skill_not_found_error..Zs6vtqAaS(vsz. Skills by that name exist in other profiles: zi. Switch profiles (`hermes -p `) to edit there, or edit the files directly (file tools / terminal).z+ Use skills_list() to see available skills.)agent.file_safetyrrrpr)rOrrrothers other_profile other_pathrds&& r+_skill_not_found_errorrNs> TF9:V:X9YY[ \D *4 0F 6{a$*1I!  7 c*V//' ( ) =  6v66  ``(target, None)`` | ``(None, error_dict)``.)validate_within_dirrN)r rr_err)r9rrtargeterrs&& r+_resolve_supporting_filerwsG8 //r *F i ( R R,?,RC #D$s) 7&$7r-c<V^8dQhR\R\R\/#)r'rOactionnot_found_suffixr[)r*s"r+r,r,s!99C999r-c\V4pV'gR\\W443#VR,pVR8Xd \W4MRpV'dRV3#VR3#)zxFind the skill; a delete also runs the background-review delete guard -> ``(skill_dir, None)`` | ``(None, error_dict)``.Nrdelete)rrrr)rOrrexistingr9guards&&& r+_locate_for_writers\4 H T0HIII I@F(@R +D &r-c \V4;'g4\V4;'g!\VRR7;'g \V4;p'd \ V4#\ V4;p'd\ RV RVR, R24#\ W4p^RIHpV!VP4VPRR7VR , p\#WVR R V4;p 'd3\%\ 4;_uu_4VP'4RRR4V #\)4p VP+V 4'dVP-V 4MTp RRRRV R2R\/V 4R\/V4RR\1V4//V'dRV/M/CRRV R2/Cp \3\5W4V4V # \d\T4'*;'d7TP4;'d\TP44'*pM \ dRpMi;iT'g\ R T R T R 24u#ELmi;i +'giT #;i)T)rzA skill named 'z' already exists at r.r!F)exist_okzCannot create skill '': zq already exists (not an empty directory, or unreadable). Choose another name, or move/remove that path and retry.rcreateNsuccessr9rz ' created.r_changerr|hintz[To add reference files, templates, or scripts, use skill_manage(action='write_file', name='z9', file_path='references/example.md', file_content='...'))rzrrrrrrrr"rmkdirFileExistsErrorrranyrrr*rrmdirrLrrr;rr@r1) rOrr|rrr9r"usablerrrdisplayrBs &&& r+ _create_skillrWsad#dd'9('Cdd'4@ddDZ[bDceseCyt$$x$odV+?@P?QQRSTT"42I8I,,- o':%Ht(JPWXXuX g   OO  =D-6-E-Ed-K-Ki##D)QZG4gdV:$>G CM9}>RSZ>[.\'&.J !2' ;;?&A&& 'F9&JHU M7  o +I66779;K;K;M77!)"3"3"566  F /vS Dnno o o  sT*F3H- H*(G7?G7G76H*7 HH*H H*H*)H*- H> c^V^8dQhR\R\R\\\3,/#)r'rOrr(rH)r*s"r+r,r,s) <  / [V]^ ^K!K NE'34N#OOO$[EEsECy !6{!CC#C" = absorbed into that umbrella, which must exist (so the model can't claim one).rrzabsorbed_into='z'' cannot equal the skill being deleted.zR' does not exist. Create or patch the umbrella skill first, then retry the delete.z Content absorbed into 'r) archive_skillzfailed to archive 'rLNrNTr9rz ' archived (rh _archivedz ' deleted.)rrrrrr;rrrrrr_rwr6shutilrmtree_rmdir_if_emptyr) rOrur9r pinned_errabsorbed_target skills_rootunsafe absorbed_noterwok archive_msgrEs && r+ _delete_skillr2s)x8IQQAdd or overwrite a supporting file within any skill directory.rzfile_content is required.rRzFile content is rz bytes (limit: z7 bytes / 1 MiB). Consider splitting into smaller files.rf write_filez& Create it first with action='create'.rNTr9File 'z' written to skill 'rrz references/r) rrrprVMAX_SKILL_FILE_BYTESrrrr*r;rrr@) rOrrr content_bytesr9rrrBs &&& r+ _write_filer\sI!),,s,Cy LB./00\009:: >RR&}Q&7G[\]F^_MNO O$\CCsCCy(|=efI  *9@KFee~dv|Yeeue yF9+=QRVQWWY*Z\bdghndo pFM** J0F/N/N/P/Pf*&<= Mr-c^V^8dQhR\R\R\\\3,/#)r'rOrr(rH)r*s"r+r,r,us.\\s\s\tCH~\r-c \V4;p'd \V4#\VR4wr4V'dV#\W14wrRV'dV#VP 4'g\ UUu.uFppW6, P 4'gK!W6, P R4F4qwP4'gK\VPV44NK6 Kr ppp\RV RV R2T;'gRR7#\WRV4;p 'dV #VP4\VPV4RR R RV R V R2/#uuppi) z2Remove a supporting file from any skill directory. remove_file*rz' not found in skill 'rN)available_filesrNTr9z' removed from skill ')rrrrrr ris_filer;rrr&r{r) rOrrr9rrsubdirr> availabler(s && r+ _remove_filerus9!),,s,Cy(}=I  *9@KF  ==??APov"+3353@I@R?Y?YZ]?^!bkbkbm3Sy12?^3 ofYK'=dV2FXaXiXieijj?m]fggzg MMOFMM9- tY& ;QRVQWWY(Z [[os-E,E"Eskill_gate_bypassr3c ^RIHpTPTP4pTP 'dR#TP 'd\TPRR7#T!T4wr4TPTPY4TP4R7p\P!RRRRR TR ,R TR TP/RR 7# \dR#i;i)zShared write gate: None to proceed, else a JSON tool result (blocked/staged). ``build_staging(wa) -> (payload, gist)`` runs only when staging. Fails open if write_approval cannot be imported.)write_approvalNFrN)summaryoriginrNTstaged pending_ididgistr9 ensure_ascii) toolsrr6 evaluate_gateSKILLSallowblocked tool_errorr9 stage_writecurrent_originjsondumps) build_stagingwadecisionpayloadrrecords& r+_run_write_gaters. *H~~~(**E::!"%MG ^^BIIwREVEVEX^ YF ::y$$ fTltY0@0@BPU WW sC CCc |aaaS\9g\P4'dR#VVV3Rlp\V4#)z[Flat-shape gate: stage the full kwargs so approval can replay them; bypassed during replay.Nc<RSRS/SP4UUu/uF wrVfK WbK uppCpRUu/uFpTSPV4;'gRbK! ppW0P!SS3/VB3#uuppiuupi)rrOr)rrr]r^)itemsr skill_gist)rkvrgist_kwrrOpayload_kwargss& r+_staging)_apply_skill_write_gate.._stagingsVVTQ'5';';'=O'=tqdad'=OQQRPqn((+11r1P R fd>g>>>PRsA2A2A8A8)_ACTION_HANDLERS_skill_gate_bypassrr)rrOrrsffl r+_apply_skill_write_gaters0 %%);)?)?)A)A? 8 $$r-rr|rrr]r^ru operationscRV^8dQhR\\\3,R\/#r'rr(r,)r*s"r+r,r,s"??S#X?C?r-c \RRVPRR4RVPRR4RVPRR4/\Uu/uFq"VPV4bK upBVB#uupi)z_Call ``skill_manage`` with the flat-shape fields (and absorbed_into/operations) of ``payload``.rrrOr_Fr) skill_manager _FLAT_OP_KEYS)rextrars&, r+_skill_manage_fromrs{  ?{{8R( ?/6{{62/F ?KK u5 ?'4 4mgkk!n m 4 ?9> ?? 5sA' cRV^8dQhR\\\3,R\/#rr,)r*s"r+r,r,s"((c3h(C(r-c\PR4p\V4\PV4# \PT4i;i)zNReplay a staged skill write, bypassing the gate (the /skills approve handler).T)rrrreset)rtokens& r+apply_skill_pendingrs=  " "4 (E(!'*  '  's 7Ac,VR,'d,VR,'g VR,e\\RR7#VR,'d\VR,VR,4#\VR,VR,VR,VR,VR,4#) zTwo shapes: old_string/new_string = targeted replacement (validated in _patch_skill so the tool and the helper give the same guidance); content alone = full rewrite (the old 'edit').rr]r^FrrOrr_)rrr[rsas&r+ _act_patchrst ||<AlO,G*E::||1V9a l33 & 1\?AlOQ{^UVWdUe ffr-rMcF\VR,VR,VR,4#)rOrr|)rWrs&r+rs ai9q}Mr-rZc6\VR,VR,4#)rOr)r[rs&r+rrsk!F)Qy\:r-rarc8\VR,VR,R7#)rOru)ru)rrs&r+rrs aiq?QRr-rcF\VR,VR,VR,4#)rOrr)rrs&r+rrsK& 1[>1^CTUr-rc6\VR,VR,4#)rOr)rrs&r+rrs\!F)Q{^Dr-cV^8dQhRR/#)r'r(Nr)r*s"r+r,r,s""26"r-c V\\4;_uu_4^RIHp\ V4p VR8XdRVR\ VP R44/M/p T PRV3RV33U U u/uFwrV 'gKWbK up p 4TPYVeTM.V 'd V R ,MRV R 7RRR4\\4;_uu_4^R I H p V !R R 7RRR4\\4;_uu_4^RI H pH pHp^RIHpVR8XdV!VV!4WVR7M8VR9d V!WWVR7M&VR8Xd VP R4'g V!V4RRR4R#uup p i +'giL;i +'giL;i +'giR#;i)zBest-effort post-mutation side effects (never break the tool): ledger, prompt-cache clear, curator telemetry (which fires ``on_skill_lifecycle`` for plugins). skill_ledgerrruarchivedrx session_idrNr)r3 after_rootevidence) clear_skills_system_prompt_cacheT)clear_snapshot) bump_patchforgetrecord_created)is_background_reviewrM) agent_createdtask_idr)rrr>rZrarr)rr6rrrr)rupdaterecord_mutationagent.prompt_builderrr_rrrtools.skill_provenancer)rrOrBrrurr ledger_before_ledger_post _evidencerrrrrrrs&&&$$$$$ r+_record_successrsd )  1D!(*&}j$vzzR]G^B_`02 \:,FV_H`+ag+a41ef$!$+agh -2KQS(-uV}4)  M  )  I(=  )  HH @ X  4/C/E#* C E E tG S x  ;(?(? 4L  h       sIAE1' E+8E+>"E1!E1FAFF+E11 F  F  F( c2V^8dQhR\R\R\R,R\R,R\R,R\R,R\R,R \R,R \R \R,R \R,R \R,R\/ #)r'rrOrNr|rrr]r^r_rurrr()r;r))r*s"r+r,r,s1212 1212%(4Z12BE*12`cfj`j12*1214t12PSVZPZ1212/2Dj12KNPT*12d 128; 12r-c aV e\Y;'gRWR7#\SV4;p e\P!V RR7#\ W#WEWgVV R7p\ SV3/VB;peV#\ SV4;pe\VRR7#\SR8Xg V'gTM\V4P4;pe"\P!\V4RR7#\V4;_uu_4Rp\\4;_uu_4^RIHp\#V4pTP%V'd VR ,MRSR 8HVR 7pRRR4\&P)SV3R l4pV!R V/VC4p\+V\,4'd VuuRRR4#VP)R4'd\/SVVWIWVR7RRR4\P!XRR7# +'giL;i +'giL;;i)zDispatch to the action handler -> JSON string. ``operations`` (atomic batch shape, see _skill_manage_batch) overrides the flat fields.N) default_namerrFr)rr|rrr]r^r_rurrMrrr)complete_packageskillc"<\RS R24#)zUnknown action 'z<'. Use: create, edit, patch, delete, write_file, remove_file)r)rrs&r+rskill_manage..(svh&b c:er-rOrN)rrurrr)r!rrrrrr rrzrrOrr`rr6rrrcapture_beforerrrr;r)rrOrr|rrr]r^r_rurrr preflightargs gate_result shape_errname_err_ledger_beforer_prehandlerrBsf&&&&&&&&&&&& r+rrs" \\T7[ [1&$?? Lzz)%88 i%++ -D/vtDtDD Q$VT22 ?)U33#6X+=T4tTXz__lzz$x.u== d # #  i 5t$D$33 $V $&HBT]a4cN! #&&v0ef&$/$/0 fc " "! $ #" ::i f n V% $* ::f5 11!  $ #s1,G+:G AG+G+'G+ G( #G++ G; c$V^8dQhR\/#r&r[)r*s"r+r,r,6s3r-cR#)uCreate, update, or delete skills — your procedural memory for recurring task types. The call is an operations array (a single edit is a list of one); it applies atomically — any failure rolls every touched skill back. Ops: create (full SKILL.md; lands in the profile's skills directory or configured skills.create_dir; must precede that skill's other ops), patch (targeted old_string/new_string fix — preferred; content alone REPLACES the whole file, read it via skill_view() first), write_file/remove_file (supporting files), delete (sole op only). Existing skills are modified wherever they live. Keep the description's first 57 chars a self-contained trigger: 'Use when . .' Write lessons, not logs: imperative rule + why, no PR numbers/dates/incident narration, one rule per lesson, references/ named by topic (extend before adding). skill_view() shows format conventions.rrr-r+_skill_manage_descriptionr6s  1r-typestringrz9Text to find (same matching semantics as the patch tool).z,Replacement; empty string deletes the match.uPath RELATIVE to the skill's own directory, e.g. 'references/api.md' — no leading slash, never absolute; first segment references/, templates/, scripts/, or assets/.cHV^8dQhR\R\R\R\/#)r'rpropsrequiredr()r;rr)r*s"r+r,r,Vs(77s74757T7r-c <RRRRRR\RRRR V.//VCR RR.VO/#) zOne self-contained per-action op shape. ``additionalProperties: false`` is what lets a grammar-constrained backend refuse another action's text slot outright.robjectadditionalPropertiesF propertiesrOrrenumr)_NAME)rrrs&&&r+ _op_schemarVsG H4e 65(VXvPVx4Xb\ab 5H5 77r-rOr parametersr r arrayzOrdered ops; each names its target skill (lowercase, hyphens/underscores, max 64 chars). Each action is its own shape; another action's text slot is invalid.ranyOfz6Full SKILL.md text (YAML frontmatter + markdown body).z)Optional category subdir (e.g. 'devops').r_booleanz(Replace all occurrences (default false).z@Optional supporting file (write_file's shape); default SKILL.md.z=Full SKILL.md rewrite (REPLACES the whole file; last resort).z!Full text of the supporting file.z%Supporting file (write_file's shape).zOCurator consolidation only: umbrella skill that absorbed this one (must exist).r)registryru📝c X\WPR4VPR4R7#)rr)rr)rr)rkws&,r+rrs"1 ffY'BFF<4H Jr-)rOtoolsetschemaemojircjV^8dQh/^\9d\P\,;R&#)r'r)__conditional_annotations___ctxvars ContextVarr))r*s"r+r,r,s/V((H''-(Wr->assetsscripts templates references)rr)r)NF)rr|rrr]r^rur) NNNNNNFNNNN)r)r]r^)rr)rr)r__doc__ contextvarsrrTr contextlibrrloggingrerypathlibrtypingrrrr r hermes_yamlrrr utilsr r r5rrrrrr/rtools.skill_manager_guardsrrrrrrrrrrrtools.skill_manager_batchrrrr r!tools.skills_guardr"r#r$ getLogger__name__r@r7rF HERMES_HOMErIrJrLrYr`rhrqrrrcompilerrr rrxrtrzrrrrrrrrrrrrrr*r1r@rFrWr[rsrr{rrrrrrrrrrrrrrr _OLD_STRING _NEW_STRING _FILE_PATHrSKILL_MANAGE_SCHEMAtools.registryrrregisterr,)rs@r+r8s * 33,4% FFFnnSS   8 $$ 8 # "_73 !  45 Bjj/ N ; m <!U!H*",5p#L*(89,[*: &R <3l"SJ 2\0190C0C1((W& %0 ?(g M : Z RUD F"J12l& xY[ x0^_  H ^ 7 N,. j 'x!FH$13k$m"VX%24_%a* $ % w$k<% (57a(c#fh&35w&y ) 4 5w!FH$13r$t)$%|#Z&=Jm(n.56}#fh Gn%o/%' x'&(*7:`*a* 9!$!+. ^ \Nc2 9z0 2EV JKr-