Skip to content

bug: One-line install lacks Skills guidance; README/Quick Start path has poor usability #1713

Description

@jingtu666

Describe the bug

After installing PowerContext via the README.md / Quick Start path, users face two usability issues:

  1. Lack of Skills guidance — users don't know how to use artifact capabilities (Memory, Experience, Skill, Handoff, Profile, Topic Memory, etc.) and need to check multiple times to confirm whether these features are actually enabled.

  2. Missing Hook trust prompt — when a user starts a new Codex session for the first time after installation, Codex prompts whether to trust the PowerContext UserPromptSubmit Hook, but the README/Quick Start does not mention this step. Users may be confused by the trust prompt, not know what to do, or accidentally skip it — causing the Hook (auto Source capture + context recall) to be silently disabled without the user realizing it.

Steps to reproduce

  1. Open Codex (already installed and logged in)
  2. Tell Codex: Help me install PowerContext: https://github.com/oceanbase/powercontext

Expected behavior

After installation, the user should immediately understand:

  1. What capabilities exist — a capability matrix listing 7 Artifact families + Source + Tag, each with a description and trigger method
  2. How to trigger each capability — a Codex conversation example for each (e.g., "remember xxx" triggers Memory, "handoff" triggers Handoff)
  3. Which require LLM, which do not — clearly label Basic memory mode vs Full memory mode capability differences
  4. Skill approval ≠ installation — explicitly state that after approval, the Skill still needs to be exported and installed to the Agent's local directory
  5. What the Hook does automatically — explain that UserPromptSubmit Hook auto-captures Source and recalls context
  6. Hook trust is required on first session — explicitly state that the first new Codex session requires trusting the PowerContext Hook, and explain what happens if not trusted

Actual behavior

Codex follows the Quick Start / README.md approach and executes the installation commands:

Environment

No response

Are you willing to submit a PR to fix this bug?

  • Yes, I would like to submit a PR.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

bugSomething isn't working

Type

No type

Projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions