Stop Writing Skills from Memory

Skills are having a moment. Every agent platform is shipping them, every team is starting a folder for them, and they're being treated like the next abstraction layer in the AI engineering stack. I think that's right. I also think most of the skills being written this week were written the same way prompts were a year ago: from memory, by hand, by someone who is pretty sure they remember what worked.

If skills are going to become part of the stack, they need provenance. Otherwise we are just rebuilding prompt libraries with nicer names.

A skill is not something you write and hope works. It should be a

Skills files have the same shadow. You write what you remember. You leave out what you forgot you knew. The session that actually worked had the real signal in it: the specific error, the config that finally took, the edge case you only hit because you were there. You just didn't keep it. What you wrote down a week later is the 80% version, confident and incomplete, missing exactly the part that would have saved the next person.

That's what a lossy export is. It looks like the original. It is missing the data you can't get back.

The silo is now between sessions

Every engineering team already knows the knowledge-silo problem: the one person who understands the flaky deploy, the fix that lives only in someone's head or a Slack thread that scrolled out of view. The 2024 Stack Overflow Developer Survey found that 45% of developers say knowledge silos hurt their productivity . The problem-solving used to happen between people, where at least someone could overhear it. Now it happens between one engineer and an agent, in a session nobody else sees. So the silo isn't just between engineers anymore. It's between sessions. Every run your agent does without capture is institutional knowledge that evaporates before it reaches anyone, including the person who ran it.

The fix isn't more documentation discipline bolted onto more tools. It's treating the work as something worth keeping. An initiative at Code Climate to promote intentional knowledge sharing — logging key decisions and documenting new tracks of work — helped boost throughput instead of a scrollback buffer, the rest follows:

• 
  You can see what worked and why. Not the summary. The actual path.


• 
  Skills come from sessions that succeeded, not from reconstruction after the fact.


• 
  Your team inherits the actual pattern, not . Session history is that repository. You don't have to author it twice. You just have to capture it once and did this end to end. He hit the same bug across two repos, then pulled the fix out of his recorded sessions instead of debugging it from scratch a second time. platform not because skills are a nice feature to have, but because the industry is about to make the same mistake with skills that it made with prompts: treating them like clever text instead of operational artifacts.
  
  
  

  A prompt library felt like progress. It was really just a drawer full of things that worked once for someone, with no record of when, where, or why. Skills inherit that flaw the moment you write them from memory. The format got better. The provenance didn't.

  
  
  

  That's the mistake paper console is built to avoid. You point it at sessions you've already run, and it to see, run, and build on. The debugging session one engineer did alone on a Tuesday becomes a skill anyone can pull up on Wednesday. That's the part that closes the silo: the knowledge stops living in one person's history and starts living where the team already looks.

  
  
  

  Generation is one step in a loop that keeps tightening every time you run it:

  
  
  
  
  
  1. Run the agent.
  
  
  2. Capture the session.
  
  
  3. Inspect what actually happened.
  
  
  4. Extract the repeated pattern.
  
  
  5. Generate the skill.
  
  
  6. Review it.
  
  
  7. Reuse it.
  
  
  8. Improve it, then the next session starts the loop again.
  
  
  
  
  

  Every step after the first depends on having kept the first. You can't inspect a session you didn't capture, and you can't extract a pattern you can't inspect. The skill is the output of that loop, not the input to it.

  
  
  

  
  
  
  Start with evidence
  

  
  
  

  Install the paper CLI:
  
  

  
  
  
  
  

  CODE Kopieren

  curl -fsSL https://download.papercompute.com/install | sh
  
  

  
  
  
  
  
  
  
  

  Then run paper start claude and start capturing. The first session you keep is the first one your team can actually learn from, and the first skill you generate from it in paper console will be the first one that started with evidence instead of a guess.

  
  
  

  Stop writing skills from memory. Your memory is a lossy export. The session isn't.

  Vollständiger Original-Bericht

  Ausführliche Details, Code-Beispiele & Hersteller-Stellungnahme auf dev.to.

  ↗ Original-Artikel auf dev.to lesen