copilot.tools 1.0.0

package/skills/tools/tools-skill/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: tools
+description: Lists all available tools and their capabilities, grouped by category. Triggered when the user types `/tools`.
+user-invocable: true
+---
+
+Copyright (C) 2026 Celestial Consulting Ltd
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as
+published by the Free Software Foundation, either version 3 of the
+License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+# `/tools` Command
+
+When the user types `/tools`, enumerate every tool available to Copilot in this session, grouped by category with a brief description of each.
+
+## Behavior
+1. Scan all tools currently available in the runtime
+2. Group by category (File I/O, Search, Git, Sub-agents, RLM, Shell/Execution, Planning, etc.)
+3. For each tool, provide the name and a one-line description of what it does
+4. Present as a readable terminal-friendly list
+
+### `/tools help` / `/tools readme`
+When the user types `/tools help` or `/tools readme`, read and display the full tools README from `~/.copilot/tools-readme.md`. This file is copied during install and contains detailed docs for all four commands: `/tools`, `/history`, `/snapshot`, and `/teach-me`.
+
+## Notes
+- Read-only — no files modified or state changed
+- The tool list is dynamic per session in Copilot — do not hardcode it
+- Do not fabricate tools; list only what's actually available in the current Copilot session

package/tools-install.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+/**
+ * Copyright (C) 2026 Celestial Consulting Ltd
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+/**
+ * Copilot Tools Installer
+ *
+ * Installs global skills for /tools, /history, /snapshot, and /teach-me.
+ * Skills are auto-discovered by GitHub Copilot when installed to ~/.copilot/skills/
+ *
+ * Usage:
+ *   node tools-install.js                          # standard installation
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const sourceDir = __dirname;
+
+// ── 1. Install skills ──────────────────────────────────
+const skillsSource = path.join(sourceDir, 'skills');
+const skillsDest = path.join(os.homedir(), '.copilot', 'skills');
+
+console.log('[1/2] Installing global Copilot skills to ~/.copilot/skills/...');
+if (fs.existsSync(skillsSource)) {
+  for (const entry of fs.readdirSync(skillsSource)) {
+    const src = path.join(skillsSource, entry);
+    if (fs.statSync(src).isDirectory()) {
+      const dest = path.join(skillsDest, entry);
+      fs.cpSync(src, dest, { recursive: true, force: true });
+      console.log(`  ✓ Installed '${entry}' skill`);
+    }
+  }
+  console.log('  All skills installed.');
+} else {
+  console.log('  ERROR: Skills folder not found.');
+  process.exit(1);
+}
+
+// ── 2. Copy tools README for /tools help ───────────────
+console.log('[2/2] Copying documentation...');
+const readmeSource = path.join(sourceDir, 'README.md');
+const readmeDest = path.join(os.homedir(), '.copilot', 'tools-readme.md');
+
+if (fs.existsSync(readmeSource)) {
+  fs.copyFileSync(readmeSource, readmeDest);
+  console.log(`  ✓ Copied README to ~/.copilot/tools-readme.md`);
+} else {
+  console.log('  WARNING: README.md not found.');
+}
+
+// ── 3. Verify ─────────────────────────────────────────
+console.log('');
+console.log('Verifying installation...');
+let errors = 0;
+
+const checklist = {
+  'history skill': path.join(skillsDest, 'history', 'SKILL.md'),
+  'tools skill': path.join(skillsDest, 'tools', 'tools-skill', 'SKILL.md'),
+  'snapshot skill': path.join(skillsDest, 'snapshot', 'SKILL.md'),
+  'teach-me skill': path.join(skillsDest, 'teach-me', 'SKILL.md'),
+  'tools readme': readmeDest
+};
+
+for (const [name, filePath] of Object.entries(checklist)) {
+  if (fs.existsSync(filePath)) {
+    console.log(`  ✓ ${name}`);
+  } else {
+    console.log(`  ✗ ${name} not found at ${filePath}`);
+    errors++;
+  }
+}
+
+console.log('');
+if (errors === 0) {
+  console.log('✅ Installation complete!');
+  console.log('');
+  console.log('The following skills are now available globally in GitHub Copilot:');
+  console.log('  • /tools     - Lists available tools and capabilities');
+  console.log('  • /history   - Shows Copilot chat session history with tokens and costs');
+  console.log('  • /snapshot  - Manages automatic file backups before edits');
+  console.log('  • /teach-me  - Interactive code quizzes with multiple themes');
+  console.log('');
+  console.log('Usage: Open VS Code, type / in the chat panel, and select a skill.');
+  console.log(`Location: ${skillsDest}`);
+} else {
+  console.log(`❌ Installation finished with ${errors} error(s).`);
+  process.exit(1);
+}