Perform code optimization and document cleanup (#1)

## Summary
- add repository-wide quality tooling and verification scaffolding, including CI workflows, pnpm workspace setup, ESLint/Prettier/markdown checks, and generated-output verification helpers
- reorganize skill sources and generation flow by introducing canonical `_source` variants, generator/manifests, reusable helper abstractions, and shared web-automation/browser utilities
- clean up and expand documentation so the root README flows into docs and skill docs, with clearer development, reviewer, installer, and workflow guidance

## Notable changes
- docs flow and consistency cleanup across `README.md`, `docs/README.md`, and related docs
- new scripts for `check`, docs verification, generated-file verification, shell portability, and safe directory replacement
- refactors in Atlassian and web-automation skill runtimes to reduce duplication and centralize reusable code
- changelog, development documentation, and CI surface updates

## Test Plan
- [ ] `pnpm run check`
- [ ] review generated/manifests and skill sync outputs
- [ ] smoke-check docs flow from `README.md` to `docs/README.md` to skill docs

## Notes
- this branch currently includes tracked `skills/web-automation/shared/node_modules` content that should be reviewed carefully as potentially noisy/accidental committed artifacts

Co-authored-by: Stefano Fiorini <stefano.fiorini@firsthorizon.com>
Reviewed-on: #1

scripts/manage-skills.mjs

@@ -203,6 +203,15 @@ async function interactiveAnswers({ dryRun = false } = {}) {
   }
 }
 
+async function readAnswers(source) {
+  if (source === "-") {
+    let content = "";
+    for await (const chunk of input) content += chunk;
+    return JSON.parse(content);
+  }
+  return JSON.parse(await readFile(path.resolve(source), "utf8"));
+}
+
 async function main() {
   const args = parseArgs(process.argv.slice(2));
   if (args.help) {
@@ -216,7 +225,7 @@ async function main() {
 
   let answers;
   if (args.answers) {
-    answers = JSON.parse(await readFile(path.resolve(args.answers), "utf8"));
+    answers = await readAnswers(args.answers);
   } else {
     answers = await buildCliSelection(args);
   }
@@ -267,7 +276,6 @@ async function main() {
           const removeAnswer = await rl.question(`Remove Superpowers for ${prompt.clientId}/${prompt.scope} too? (yes/no) [no]: `);
           if (removeAnswer.trim().toLowerCase() === "yes") {
             const scope = resolveClientScope(prompt.clientId, prompt.scope, process.cwd());
-            const client = CLIENTS[prompt.clientId];
             const target = `${scope.skillsRoot}/superpowers`;
             plan.operations.push({ kind: "superpowers", clientId: prompt.clientId, scope: prompt.scope, action: "remove", target, skillsRoot: scope.skillsRoot });
           }