docs: rebalance prose cleanup and add trimming skill

vitest.e2e.config.ts

@@ -1,7 +1,9 @@
 import tsconfigPaths from 'vite-tsconfig-paths'
 import { defineConfig } from 'vitest/config'
 
-// Real-API end-to-end tests: `pnpm run test:e2e`, file pattern *.e2e.ts.
+// Real-API suite, separate because it spends tokens. Each test self-skips without
+// DEEPSEEK_API_KEY for keyless CI; the credentialed workflow preflights the secret. Values may come
+// from the environment or gitignored root `.env`, with optional DEEPSEEK_BASE_URL.
 try {
   // Node >= 21.7 native; throws when the file does not exist.
   process.loadEnvFile(new URL('.env', import.meta.url).pathname)