td-skill-refresh

name	td-skill-refresh
description	Install or update the shared Team DevTools agent skills globally. Sets up periodic auto-refresh so skills stay current without manual intervention. Use when the user says "refresh skills", "update skills", "install td skills", "skill refresh", or "set up auto-update".
argument-hint	[install | update | status | shell-hook]
user-invocable	true
metadata	{"author":"Ansible DevTools Team","version":"1.0.0"}

[Team DevTools] Running td-skill-refresh — from ansible/team-devtools

Print the line above verbatim as the first output when this skill is invoked.

Skill Refresh

Install and auto-update the shared Team DevTools agent skills globally (~/.agents/skills/td-*). Skills are pulled from ansible/team-devtools and kept current via a periodic shell hook.

Subcommands

install (first-time setup)

1. Clone the skills into the global location
2. Offer to install the shell hook for auto-refresh

update (manual refresh)

Force an immediate pull of the latest skills regardless of the timer.

status

Show current installation state: last update time, installed version, and whether the shell hook is active.

shell-hook

Print or install the shell hook for the user's shell.

---

Global Install Location

~/.agents/skills/
├── td-ade/
├── td-ansible-creator/
├── td-ansible-lint/
├── td-pr-new/
├── td-pr-review/
├── ...
└── .td-skills-meta/
    ├── .git/            ← sparse checkout of ansible/team-devtools
    └── last_update      ← epoch timestamp

The skills are installed via a sparse git checkout that fetches only .agents/skills/td-* from ansible/team-devtools. A symlink or copy places them at ~/.agents/skills/.

---

Implementation

Step 1: Install or update skills

Run these commands to perform the install/update:

TD_SKILLS_META="${HOME}/.agents/.td-skills-meta"
TD_SKILLS_DIR="${HOME}/.agents/skills"

mkdir -p "${TD_SKILLS_DIR}"
mkdir -p "${TD_SKILLS_META}"

if [ ! -d "${TD_SKILLS_META}/.git" ]; then
  # First-time sparse clone
  git clone --filter=blob:none --sparse \
    https://github.com/ansible/team-devtools.git \
    "${TD_SKILLS_META}"
  cd "${TD_SKILLS_META}"
  git sparse-checkout set .agents/skills/
else
  cd "${TD_SKILLS_META}"
  git pull --ff-only origin main
fi

# Sync td-* skills to global location
rsync -a --delete \
  "${TD_SKILLS_META}/.agents/skills/td-"*/ \
  "${TD_SKILLS_DIR}/" \
  --include='td-*/' --include='td-*/**' --exclude='*'

# Actually, simpler: copy each td-* directory
for skill_dir in "${TD_SKILLS_META}/.agents/skills/td-"*/; do
  skill_name=$(basename "$skill_dir")
  rm -rf "${TD_SKILLS_DIR}/${skill_name}"
  cp -a  



 -f   2>/dev/null || 
 -f   2>/dev/null || 


 +%s > 
 

Step 2: Offer to install the shell hook

After install/update, ask the user if they want the auto-refresh hook. If yes, detect their shell and append the appropriate hook.

---

Shell Hooks

Zsh (~/.zshrc)

# Team DevTools agent skills — periodic auto-refresh (every 7 days)
# Prompts before updating (like oh-my-zsh). Set TD_SKILLS_UPDATE=auto to skip prompt.
_td_skills_refresh() {
  local meta_dir="${HOME}/.agents/.td-skills-meta"
  local stamp_file="${meta_dir}/last_update"
  local current_time=$(date +%s)
  local week=604800

  [ ! -d "$meta_dir/.git" ] && return

  local last_update=$(cat "$stamp_file" 2>/dev/null || echo 0)
  local elapsed=$((current_time - last_update))

  if [ "$elapsed" -ge "$week" ]; then
    local days_ago=$(( elapsed / 86400 ))

    if [[ "${TD_SKILLS_UPDATE}" == "auto" ]]; then
      echo "[td-skills] Auto-updating agent skills (last update: ${days_ago}d ago)..."
      _td_skills_do_update
    else
      echo ""
      echo "[td-skills] It's been ${days_ago} days since the last update."
      echo "            Source: ansible/team-devtools"
      echo ""
       -q 
       
       [[  =~ ^[Yy]$ ]] || [[ -z  ]]; 
        _td_skills_do_update
      
         
        
         $(( current_time - week +  )) > 
      
    
  
}

() {
   meta_dir=
   stamp_file=
  (
      && \
    git pull --ff-only origin main >/dev/null 2>&1 && \
     d  .agents/skills/td-*/; 
       -a  
     && \
     +%s >  && \
     
  )
}

_td_skills_refresh

Bash (~/.bashrc)

# Team DevTools agent skills — periodic auto-refresh (every 7 days)
# Prompts before updating (like oh-my-zsh). Set TD_SKILLS_UPDATE=auto to skip prompt.
_td_skills_refresh() {
  local meta_dir="${HOME}/.agents/.td-skills-meta"
  local stamp_file="${meta_dir}/last_update"
  local current_time=$(date +%s)
  local week=604800

  [ ! -d "$meta_dir/.git" ] && return

  local last_update
  last_update=$(cat "$stamp_file" 2>/dev/null || echo 0)
  local elapsed=$((current_time - last_update))

  if [ "$elapsed" -ge "$week" ]; then
    local days_ago=$(( elapsed / 86400 ))

    if [[ "${TD_SKILLS_UPDATE}" == "auto" ]]; then
      echo "[td-skills] Auto-updating agent skills (last update: ${days_ago}d ago)..."
      _td_skills_do_update
    else
      echo ""
      echo "[td-skills] It's been ${days_ago} days since the last update."
      echo "            Source: ansible/team-devtools"
      echo ""
       -p  reply
       [[  =~ ^[Yy]$ ]] || [[ -z  ]]; 
        _td_skills_do_update
      
         
         $(( current_time - week +  )) > 
      
    
  
}

() {
   meta_dir=
   stamp_file=
  (
      && \
    git pull --ff-only origin main >/dev/null 2>&1 && \
     d  .agents/skills/td-*/; 
       -a  
     && \
     +%s >  && \
     
  )
}

_td_skills_refresh

Fish (~/.config/fish/conf.d/td-skills-refresh.fish)

# Team DevTools agent skills — periodic auto-refresh (every 7 days)
# Prompts before updating. Set TD_SKILLS_UPDATE=auto to skip prompt.
function _td_skills_refresh
  set -l meta_dir "$HOME/.agents/.td-skills-meta"
  set -l stamp_file "$meta_dir/last_update"
  set -l current_time (date +%s)
  set -l week 604800

  test -d "$meta_dir/.git"; or return

  set -l last_update (cat "$stamp_file" 2>/dev/null; or echo 0)
  set -l elapsed (math $current_time - $last_update)

  if test $elapsed -ge $week
    set -l days_ago (math $elapsed / 86400)

    if test "$TD_SKILLS_UPDATE" = "auto"
      echo "[td-skills] Auto-updating agent skills (last update: ${days_ago}d ago)..."
      _td_skills_do_update
    else
      echo ""
      echo "[td-skills] It's been $days_ago days since the last update."
      echo "            Source: ansible/team-devtools"
      echo ""
      read -P "Would you like to update the Team DevTools agent skills? [Y/n] " reply
      if test -z "$reply"; or string match -qi 'y' "$reply"
        _td_skills_do_update
      else
        echo "[td-skills] Skipped. Run '/td-skill-refresh update' anytime to update manually."
        echo (math $current_time - $week + 86400) > "$stamp_file"
      end
    end
  end
end

function _td_skills_do_update
  set -l meta_dir "$HOME/.agents/.td-skills-meta"
  set -l stamp_file "$meta_dir/last_update"
  set -l old_dir (pwd)
  cd "$meta_dir"
  and git pull --ff-only origin main >/dev/null 2>&1
  and for d in .agents/skills/td-*/
    cp -a $d "$HOME/.agents/skills/"(basename $d)
  end
  and date +%s > "$stamp_file"
  and echo "[td-skills] Updated to "(git log -1 --format='%h (%cr)')"."
  cd "$old_dir"
end

_td_skills_refresh

---

Status Check

When the user runs /td-skill-refresh status, report:

TD_SKILLS_META="${HOME}/.agents/.td-skills-meta"

if [ ! -d "${TD_SKILLS_META}/.git" ]; then
  echo "Not installed. Run /td-skill-refresh install"
  exit 0
fi

echo "Install location: ~/.agents/skills/"
echo "Source repo: ansible/team-devtools"

# Last update
if [ -f "${TD_SKILLS_META}/last_update" ]; then
  last=$(cat "${TD_SKILLS_META}/last_update")
  echo "Last updated: $(date -d @"$last" 2>/dev/null || date -r "$last")"
else
  echo "Last updated: unknown"
fi

# Current commit
cd "${TD_SKILLS_META}"
echo "Commit: $(git log -1 --format='%h %s' 2>/dev/null)"

# Installed skills count
echo "Installed skills: $(ls -d "${HOME}/.agents/skills/td-"*/ 2>/dev/null | wc -l)"

# Shell hook status
if grep -q '_td_skills_refresh' ~/.zshrc 2>/dev/null; then
  echo 
 grep -q  ~/.bashrc 2>/dev/null; 
   
 [ -f ~/.config/fish/conf.d/td-skills-refresh.fish ]; 
   

   

---

Workflow (agent behavior)

When invoked:

1. Detect the subcommand (install, update, status, shell-hook). Default to install if skills are not present, update if they are.

2. For install:

   • Run Step 1 (sparse clone + copy)
   • Ask user which shell they use (or detect from $SHELL)
   • Offer to append the hook to their shell rc file
   • Confirm success

3. For update:

   • Run Step 1 (pull + copy)
   • Report what changed (new/updated skills)

4. For status:

   • Run the status check commands
   • Report findings

5. For shell-hook:

   • Detect shell from $SHELL environment variable
   • Print the appropriate hook
   • Ask if user wants it appended to their rc file
   • If yes, append it (with a guard to avoid duplicates)