SuperAPI AI Directory

skill-hide

Office & productivity

View repository

Updated 10-16 04:42

About this skill

Skill Hide Manager

⚠️ Mandatory Rules (AI must comply)

Rule 1: Ambiguous words must be asked about

When the user input contains the followingambiguous words,it is forbidden to directly execute any operation, and you must first ask for confirmation:

Ambiguous word Must ask
"display" ✅ Must ask
"show" ✅ Must ask

Correct process:

用户: "显示所有技能"
AI:  "'显示'有两种含义:
     [1] 恢复(取消隐藏)技能
     [2] 查看/列出技能列表
     请回复 1 或 2:"

Incorrect behavior (forbidden):

  • ❌ Directly list skills
  • ❌ Directly restore skills
  • ❌ Assume the user's intent

Rule 2: Non-ambiguous words are executed directly

User input Intent Execute directly
"hide xxx" Hide skill hide_skill.py xxx
"view/list xxx" Preview skill --show-all
"restore xxx" / "unhide xxx" Restore skill unhide_skill.py xxx
"which ones are hidden" View hidden list list_hidden.py

Terminology

Term Meaning Corresponding operation
Hide Mark the skill as hidden hide_skill.py
Restore Unhide, making the skill visible again unhide_skill.py
Preview/view/list Only view the skill list, without modifying --show-all

Prerequisites

  • Dependencies: Python standard library, no additional dependencies required

Configuration Management

First-time use requires configuring the skill parent folder path.

Configuration Method

Path format description: use forward slashes / compatible with Windows CMD, PowerShell, and Unix-like shells (Git Bash, MSYS2, WSL)

# 添加单个路径
python skill-hide/scripts/config_manager.py --add "C:/path/to/skills"

# 添加多个路径
python skill-hide/scripts/config_manager.py --add "C:/path1" --add "D:/path2"

# 覆盖设置所有路径(逗号分隔)
python skill-hide/scripts/config_manager.py --set "C:/path1,D:/path2,E:/path3"

# 列出当前配置
python skill-hide/scripts/config_manager.py --list

# 清空所有配置
python skill-hide/scripts/config_manager.py --clear

# 不带参数运行,显示当前配置和参考路径
python skill-hide/scripts/config_manager.py

Operation Steps

Hide Skill

# 隐藏单个
python skill-hide/scripts/hide_skill.py <skill-name>

# 隐藏多个
python skill-hide/scripts/hide_skill.py <skill1> <skill2>

# 隐藏所有(所有配置文件夹)
python skill-hide/scripts/hide_skill.py --all

# 隐藏指定文件夹下的所有技能
python skill-hide/scripts/hide_skill.py --all --folder <path>

# 指定文件夹
python skill-hide/scripts/hide_skill.py <skill-name> --folder <path>

Restore Skill

# 恢复单个
python skill-hide/scripts/unhide_skill.py <skill-name>

# 恢复多个
python skill-hide/scripts/unhide_skill.py <skill1> <skill2>

# 恢复所有(所有配置文件夹)
python skill-hide/scripts/unhide_skill.py --all

# 恢复指定文件夹下的所有技能
python skill-hide/scripts/unhide_skill.py --all --folder <path>

# 指定文件夹
python skill-hide/scripts/unhide_skill.py <skill-name> --folder <path>

Preview Skill (view only, no modification)

# 查看所有配置文件夹的技能状态(多文件夹场景)
python skill-hide/scripts/hide_skill.py --show-all

# 查看指定文件夹的技能状态
python skill-hide/scripts/hide_skill.py --show-all --folder <path>

# 查看所有已隐藏的技能(跨所有配置文件夹)
python skill-hide/scripts/list_hidden.py

# 查看操作历史记录
python skill-hide/scripts/list_history.py

# 查看操作过的文件夹列表
python skill-hide/scripts/list_history.py --folders

Resource Index

  • scripts/config_manager.py - Read/write configuration
  • scripts/hide_skill.py - Hide skills / view all skill statuses (supports multiple folders)
  • scripts/unhide_skill.py - Restore skills
  • scripts/list_hidden.py - List all hidden skills (across folders)
  • scripts/list_history.py - View operation history

Notes

  1. Forbidden to hide itself: skill-hide cannot hide itself
  2. Path normalization: automatically unify to use forward slashes /
  3. Multi-directory support:
    • Multiple skill parent folder paths can be saved in the configuration file
    • When hiding/restoring skills, all configured folders will be searched
    • --show-all When not specifying --folder , the status of all configured folders will be displayed
  4. Skills with the same name: Skills with the same name can exist in different folders; when hiding/restoring, all matching skills will be operated on
  5. Configuration file: skill-hide/.skill-config.json

⚠️ Important: AI Usage Guide

How to determine whether a skill is hidden

Do not rely solely on tool output, you must verify through the file system:

# 正确:直接检查文件存在性
ls -la skill-folder/
# 显示状态: SKILL.md 存在
# 隐藏状态: SKILL.md.hide 存在, SKILL.md 不存在

Determination logic:

File existence status Status
SKILL.md exists ✅ Visible
SKILL.md.hide exists, and SKILL.md does not exist ❌ Hidden

Known issues

  1. Windows console encoding issue: script output in Chinese may appear garbled (does not affect actual functionality)
  2. Verification mechanism: after all hide/restore operations, the file status should be verified to ensure the operation succeeded

Quick reference table

User input Ambiguous? AI action
"hide xxx" ❌ Execute hide directly
"view/list xxx" ❌ Execute preview directly
"restore/unhide xxx" ❌ Execute restore directly
"show xxx" ✅ Must ask
"display xxx" ✅ Must ask
"which ones are hidden" ❌ Execute list_hidden.py directly